VPU Auth Web Component

GitLab Repository

Usage

<vpu-auth></vpu-auth>

Attributes

• lang (optional, default: de): set to de or en for German or English
  • example <vpu-auth lang="de" </vpu-auth>
• load-person (optional, default: off): if enabled the logged in user will also be loaded as Person in the window.VPUPerson variable
  • example <vpu-auth load-person></vpu-auth>
• force-login (optional, default: off): if enabled a login will be forced, there never will be a login button
  • example <vpu-auth force-login></vpu-auth>
• try-login (optional, default: off): if enabled the a login will happen if the user is already logged in and finishing the login process would not result in a page location change (reload/redirect).
  • example <vpu-auth try-login></vpu-auth>
• keycloak-config: An object which can contain the following keys: url, realm, clientId, silentCheckSsoRedirectUri
  • example <vpu-auth keycloak-config='{"url": "https://auth.tugraz.at/auth", "realm": "tugraz", "clientId": "some-id", "silentCheckSsoRedirectUri": ""}'></vpu-auth>

Events to listen to

• vpu-auth-init: Keycloak init event - happens once
• vpu-auth-person-init: Keycloak person init event - the person entity was loaded from the server
• vpu-auth-keycloak-data-update: Keycloak data was updated - happens for example every time after a token refresh

Local development

# get the source
git clone git@gitlab.tugraz.at:VPU/WebComponents/Auth.git
cd Auth
git submodule update --init

# install dependencies (make sure you have npm version 4+ installed, so symlinks to the git submodules are created automatically)
npm install

# constantly build dist/bundle.js and run a local web-server on port 8002 
npm run watch-local

Jump to http://localhost:8002 and you should get a Single Sign On login page.