Wie richten Sie SSO für Ihr Alohi-Konto über Okta ein?

Alohi SSO funktioniert für Fax.Plus und Sign.Plus. Um Single Sign-On (SSO) und die automatische Benutzerbereitstellung (SCIM) über Okta zu aktivieren und Ihrem Team den Zugriff auf Fax.Plus oder Sign.Plus über das Okta-Dashboard zu ermöglichen, benötigen Sie Admin-Zugriff sowohl auf Okta als auch auf Ihr Fax.Plus- oder Sign.Plus-Konto.

Lassen Sie Okta und Fax.Plus oder Sign.Plus in separaten Browser-Tabs geöffnet, da Sie Werte zwischen beiden kopieren müssen.

Führen Sie nach der Bestätigung die folgenden Schritte aus, um SSO über Okta einzurichten:

Schritt 1: Neue App-Integration in Okta erstellen

1. Gehen Sie in der Okta Admin Console zu Applications and Resources > Applications > Create App Integration.
   
2. Lassen Sie im Dialogfeld Okta Integration Wizard ausgewählt und klicken Sie auf Next.
   

Schritt 2: Funktionen auswählen

1. Aktivieren Sie Folgendes:
   • SSO (Single Sign-On): Wählen Sie Security Assertion Markup Language (SAML) aus. Lassen Sie OpenID Connect (OIDC) deaktiviert.
   • Provisioning: Wählen Sie SCIM 2.0 aus.
2. Klicken Sie unten auf der Seite auf Add integration details.
   

Schritt 3: Integrationsdetails hinzufügen

1. Füllen Sie die folgenden Felder aus:
   • Display name: Alohi
   • Description: eine aussagekräftige Beschreibung, zum Beispiel „Alohi SSO Integration“
   • Tenant settings: leer lassen
   • Authentication settings > Authentication mode: Wählen Sie Bearer aus.
2. Klicken Sie auf Configure your integration.
   

Schritt 4: Integration konfigurieren

1. Geben Sie unter SAML properties Folgendes ein:

   • Default ACS URL: https://sso.alohi.com/login
   • Entity ID / audience restriction: https://sso.alohi.com/metadata

   Lassen Sie alle anderen Felder leer.
   

2. Geben Sie unter SCIM provisioning properties Folgendes ein:
   • Base URL: https://sso.alohi.com/scim/v2
   • What objects do you want Okta to manage in your integration?: Lassen Sie Users vorausgewählt.
   • User operations: Aktivieren Sie Create, Read (vorausgewählt), Update, Deactivate und Support PATCH for User. Lassen Sie Change password und Import User Schema deaktiviert.
3. Klicken Sie unten auf der Seite auf Review and deploy.
   

Schritt 5: Überprüfen und bereitstellen

1. Überprüfen Sie Ihre Einstellungen.
2. Klicken Sie unten auf der Seite auf Deploy changes.
   

Schritt 6: App-Instanz hinzufügen

1. Stellen Sie sicher, dass Application label auf „Alohi“ gesetzt ist.
2. Klicken Sie auf Done.
   

Schritt 7: SSO in Fax.Plus oder Sign.Plus aktivieren

1. Öffnen Sie in Okta die Alohi-Anwendung und gehen Sie zu Sign On > Sign on methods > SAML 2.0. Erweitern Sie anschließend More details.
   
2. Melden Sie sich in einem separaten Tab bei Ihrem Fax.Plus-Konto an und gehen Sie zu Einstellungen > Sicherheit.
3. Klicken Sie im Feld Access Management neben Single Sign-On (SSO) auf Activate.

4. Kopieren Sie die folgenden Werte aus Okta und fügen Sie sie in Fax.Plus oder Sign.Plus ein:

   Okta	Fax.Plus / Sign.Plus
   Sign on URL	Single Sign-On URL
   Issuer	Entity ID
   Signing Certificate	X.509 Certificate

5. Klicken Sie auf Next.
   
6. Wählen Sie im Schritt User Provisioning (SCIM) die gewünschten Product Assignment-Optionen aus und kopieren Sie dann das SCIM Token. Sie fügen es im nächsten Schritt in Okta ein.
   

Schritt 8: API-Integration in Okta aktivieren

1. Öffnen Sie in Okta die Registerkarte Provisioning der Alohi-Anwendung und klicken Sie auf Configure API Integration.
2. Fügen Sie das SCIM-Token in das Feld API Token ein.
3. Deaktivieren Sie das Kontrollkästchen Import Groups.
4. Optional: Klicken Sie auf Test API Credentials, um die Einrichtung zu überprüfen. Es sollte die Meldung „Alohi was verified successfully!“ angezeigt werden.
5. Klicken Sie auf Save.
   
   

Schritt 9: Provisionierung für die App einrichten

1. Klicken Sie unter Provisioning > To App auf Edit.
2. Aktivieren Sie die folgenden Optionen:
   • Create Users
   • Update User Attributes
   • Deactivate Users
3. Lassen Sie alle anderen Einstellungen unverändert und klicken Sie auf Save.
   

Schritt 10: Anwendungsbenutzernamen festlegen

1. Kehren Sie zur Registerkarte Sign On zurück und klicken Sie oben rechts auf Edit.
   
2. Setzen Sie Application username format auf Email.
3. Klicken Sie auf Save.
   

Schritt 11: Benutzer zuweisen

1. Öffnen Sie die Registerkarte Assignments.
2. Weisen Sie Benutzer oder Gruppen gemäß den Richtlinien Ihrer Organisation zu. Zugewiesene Benutzer werden durch die Provisionierung automatisch in Fax.Plus oder Sign.Plus angelegt.
3. Die Benutzer können sich nun über die Alohi-SSO-Integration bei ihrem Konto anmelden.
   

Benutzerinformationen aktualisieren

Wenn Ihre Organisation eine Domain geändert hat oder ein Benutzer seinen Nachnamen geändert hat, müssen Sie die Benutzerdaten über Ihren IdP aktualisieren – in diesem Fall Okta. Die Änderung muss im Profil des Benutzers erfolgen. Eine Aktualisierung über die Seite „Assignments“ funktioniert nicht.

Anleitungsvideos

Anleitungsvideos