Configuratiehandleiding voor Okta SSO

Een Okta SSO-applicatie aanmaken

  1. Ga naar Applications > Applications en klik op Create App Integrationimage-20221220-102403.png

  2. Selecteer SAML 2.0 en klik op Next

    image-20221220-102631.png

     

  3. Vul App name in en klik op Next. Selecteer eventuele App visibility-opties. Een logo is hier niet nodig, omdat deze applicatie niet aan gebruikers wordt getoond; zie Bookmark-applicatie.
image-20221220-103524.png

Metadata

De benodigde SAML 2.0-gegevens haal je het eenvoudigst uit metadata, op twee manieren:

  1. Open de URL in je browser, of download het bestand en open het in een teksteditor.
  2. De tabel koppelt Okta-velden aan XML-tags in de Asset Federation Metadata.

Okta

Metadatatag

Single sign-on URL 

md:AssertionConsumerService > Location

Audience URI (SP Entity ID) 

md:EntityDescriptor > entityID

Name ID format

Transient

image-20221220-104455.pngimage-20221220-104403.pngimage-20221220-104827.png
  1. Voeg onder Attribute Statements (optional) minimaal user.email, user.firstName en user.lastName toe. Deel de waarden in Name met je Spacewell-contactpersoon. Voeg extra attributen toe via Add Another.

image-20221220-113207.png
  1. Klik op Next
image-20221220-113250.png
  1. Selecteer I’m an Okta customer adding an internal app en This is an internal app that we have created.
  1. Klik op Finish
image-20221220-113345.png
  1. Ga naar SAML Signing Certificates.
  2. Open het actieve certificaat → Actions → View IdP metadata.
  3. Een tabblad met de Metadata URL verschijnt. Noteer deze en deel hem met Spacewell.
image-20221220-113952.png

Een Okta Bookmark-applicatie aanmaken (optioneel)

Voor inloggen vanuit Okta naar Asset is een Bookmark-applicatie nodig. De SSO-applicatie ondersteunt geen inlog-URL, een Bookmark-applicatie wel.

Ga naar Applications > Applications → Browse App Catalog

image-20221220-125824.png
  1. Zoek Bookmark en selecteer Bookmark Appimage-20221220-125915.png

  2. Klik op Add Integration

    image-20221220-125947.png

  3. Vul Application Label en URL in. Meestal is de URL als volgt: https://client.axxerion.com/axxerion/sso
    Vervang client door je klantspecifieke waarde. Bij meerdere SSO-verbindingen in één omgeving kan de URL anders zijn; overleg met Spacewell.

  4. Klik op Done
image-20221220-130225.png

Gebruikers toewijzen

Wijs gebruikers ten minste aan de SSO-applicatie toe en eventueel aan de Bookmark-applicatie.

  1. Open Assignments → Assign en kies People of Groupsimage-20221220-134323.png

  2. Selecteer in dit voorbeeld een gebruiker, klik op Assign en daarna Done

    image-20221220-134503.png

  3. De gebruikers verschijnen in de applicatie

image-20221220-134536.png

Een applicatielogo toevoegen (optioneel)

  1. Download desgewenst het onderstaande Asset-logo.
  2. Klik op het logo om het te vergroten.
  3. Download het via het pictogram rechtsboven.Workplace-rgb-color-640x160.png

  4. Open de applicatie en klik op de pen bij het bestaande logo

    image-20221220-134653.png

     

  5. Selecteer de afbeelding en klik op Update Logo
image-20221220-134804.png

Certificaten vernieuwen

  • Asset vernieuwt het SSO-certificaat jaarlijks. Okta accepteert dit momenteel zonder verdere handelingen aan jouw zijde.
  • Meld vernieuwing van het Okta-certificaat zo snel mogelijk via Support. Met de Federation Metadata URL kan Spacewell de Asset-instellingen eenvoudig bijwerken. Zonder melding stopt de verbinding zodra het Okta-certificaat verloopt.