West-Life Virtual Research Environment Docs
  • Introduction
  • Data Management
  • Virtual Folder
    • User's guide
      • Settings
        • Import settings from another Virtual Folder
      • File Manager
      • File Picker
      • Related applications
        • Jupyter notebook
      • Metadata
    • Installation guide
      • Cloud installation
      • Local installation
      • Integration with SSO
    • Integration guide
      • Select File or Dir from Virtual Folder
      • Working with WEBDAV
      • Embedding Virtual Folder Component
      • Adding component into Virtual Folder
    • Developer's guide
      • Backend
      • Frontend - Web Application
      • Metadata and API
        • Dataset metadata and API
        • File metadata and API
      • Import Export Settings API
      • Related application and services
      • Untitled
  • Virtual Machines and Containers
    • Preparing vagrant VM template
    • Preparing docker container
  • Repository
    • Installation guide
      • Prerequisites
      • Automatic installation
      • Manual installation from source codes
    • User's guide
      • Scientist imports project proposal
      • Staff uploads data
      • Scientist works with dataset
      • Metadata
    • Developer's guide
      • Metadata generation
      • ARIA integration
Powered by GitBook
On this page
  1. Virtual Folder
  2. Installation guide

Integration with SSO

By default, VF works in single user environment as user 'vagrant'. To enable multiuser environment, you need to integrate it with West-Life SSO. VF instance have unique sp-metadata,idp-metadata,sp_keyandsp_cert files.

  • If you have it from previous installation, then put it next to the VagrantFile, or put them into virtual machine/container folder /vagrant and exectue this script in bash within VF machine or container:

    export SSO_DEPLOYMENT=1
    wp6-virtualfolder/bootstrap/bootstrapsso.sh
  • If you don't have keys and certificates yet, then execute this script in bash within VF machine or container:

    export SP_IDENTIFICATION=http://[your public domain of repository]
    export SP_ENDPOINT=http://[your public domain of repository]/mellon
    export SSO_DEPLOYMENT=1
    wp6-virtualfolder/bootstrap/bootstrapsso.sh
  • Find the generated file sp-metadata.xml and register it with West-Life SSO administrator - send it to westlife-aai@ics.muni.cz

Note that

export SP_IDENTIFICATION=http://[your public domain of repository] defines id of service provider - your instance of virtual folder, so to be unique put your public domain, e.g. https://portal.west-life.eu/

export SP_ENDPOINT=http://[your public domain of repository]/mellon defines endpoint where mellon plugin is available in VF installation, e.g. https://portal.west-life.eu/mellon/

export SSO_DEPLOYMENT=1 just sets trigger for further script

bootstrapsso.sh configures VF with SSO, installs mellon plugin into apache, configures aliases, if the keys are not present in /vagrant/sp_key.pem then the keys are generated based on SP_IDENTIFICATION and SP_ENDPOINT, and puts generated keys into expected folders into /etc/...

PreviousLocal installationNextIntegration guide

Last updated 6 years ago