Zum Ende der Metadaten springen
Zum Anfang der Metadaten

Sie zeigen eine alte Version dieser Seite an. Zeigen Sie die aktuelle Version an.

Unterschiede anzeigen Seitenhistorie anzeigen

« Vorherige Version anzeigen Version 6 Nächste Version anzeigen »

This tutorial explains how to install the Login App.

Install Login App

You can either

  • A) download the App from the download page and install it manually or

  • B) use the UM Kickstarter

Either way you’ll need a license that covers de.pinuts.cmsbs.Auth2 to successfully install and use the Login App. Please contact support@pinuts.de when in doubt.

A) Install manually

If you need to install into an already existing UM you probably need to perform a manual installation as described in this section.

Go to https://www.universal-messenger.de/knowledge-base/intern/02_downloads/addons/index.html and download the Login App package (ZIP file).

Unzip the file right into your UM folder (where subfolders like cmsbs-conf/ and cmsbs-work/ live):

cd UM
unzip $DOWNLOAD_DIR/LoginApp-x.y.z.zip

Restart your UM instance.

B) Install using UM Kickstarter

Start a new Kickstarter project

See Install Kickstarter

umkickstarter -n de.pinuts.tutorial um

Add Auth2 as a dependency

Edit um/build.gradle to add Auth2:

dependencies {
    // ...
    runtime('de.pinuts.cmsbs:Auth2:4.6.2')
}

Let gradle install the new dependency and start your UM instance:

cd um && gradle setup run

Login to http://localhost:8080/cmsbs as admin / admin

Create a Segment to define the authorized users

A Segment is used to define which Entries in the UM are allowed to perform a login. All members of this Segment are authorized to login.

In this example, all Entries that have an email address are authorized, but all segmentation options could be used here, e.g., inChannel('loginusers') or isSet(login_allowed).

Go to Groups / New Segment and perform the desired segmentation. After that, save your settings as new Segment named can_login:

Create Segments to represent permissions

Go to Groups / New Segment and create some Segments that will later be used to represent the different permissions a user of your web app might be granted.

Provide all of these Segments with the Semantic tag permission.

Create Login App Instance

Go to Tools / Apps / Login and Authorization and create a new instance:

Set the unique name to my-app.

Enter a Title.

Select English as the Used language.

Select the Segment named can_login as the User base.

Enter permission as the Sematic tag to identify Segments representing web user permissions.

Set URL of the REST proxy to /p.

Create a user Entry

Go to Entries / New Entry and create at least one customer user Entry that…

  • has an email address

  • and a password

  • and is member of at least one of the “permissions” Segments you created earlier.

Configure and install REST Proxy

Muss auch manuell möglich sein; dann ggf. andere URL!

Create a file named um/rest-proxy/cmsbs-restproxy.properties that configures the REST Proxy:

cmsbs.resturl=http://localhost:8080/cmsbs/rest

cmsbs.restproxy.limit.controller.whitelist.1 = "de.pinuts.cmsbs.lib.widget.Pi"
cmsbs.restproxy.limit.controller.whitelist.2 = "de.pinuts.cmsbs.auth2.Auth"
cmsbs.restproxy.limit.controller.whitelist.3 = "de.pinuts.cmsbs.auth2.Widget"

Insert the following cp lines to your um/build.gradle file:

setup.doLast {
    ...
    // UM REST Proxy
    cp('UM/web-integration/cmsbs-restproxy.war', new File(pinuts.um.webappsDir, 'p.war'))
    cp('rest-proxy/cmsbs-restproxy.properties', new File(pinuts.um.serverHome, 'cmsbs-restproxy.properties'))
}

Now, setup and restart your UM instance:

gradle setup run

Give it a try

Now, you should be able to login to your sample web app using the custom users' credentials you created earlier: http://localhost:8000/

  • Keine Stichwörter