Durch die Integration von Lucid mit ADFS können sich Ihre Benutzer mit SAML-Single-Sign-On über ADFS authentifizieren. Das folgende Tutorial führt durch den Prozess der Integration von ADFS mit Lucid.

Die SAML-Integration ist nur für Enterprise-Konten verfügbar. Um Ihr Konto zu aktualisieren, besuchen Sie unsere Übersichtstabelle und Lucidspark Preisseiten oder kontaktieren Sie unser Verkaufsteam.

Laden Sie die Föderationsmetadaten herunter und importieren Sie sie in Lucid

1. Laden Sie die Föderationsmetadaten herunter.
  - Auf die Verbundmetadaten kann auf dem ADFS-Server unter der folgenden URL zugegriffen werden. Ersetzen Sie dabei [myserver.domain] durch die URL Ihres ADFS-Servers:
    https://[meinserver.domain].com/FederationMetadata/2007-06/FederationMetadata.xml
2. Navigieren Sie zum Admin-Panel von Lucid.
3. Wählen Sie die Registerkarte App-Integration .
4. Wählen Sie im Dropdown-Menü „App-Integration“ die Option „Allgemein“aus.
5. Klicken Sie in der Integrationskachel „SAML“ auf Einstellungen .
6. Laden Sie die XML-Metadaten mithilfe der Dateiauswahl in Lucid hoch.
  - Hinweis: Wenn Sie dies im Textformat haben, speichern Sie es bitte als XML-Datei und laden Sie es dann auf Lucid hoch.

Konfigurieren Sie den Lucid Relying Party Trust in ADFS

Erstellen und konfigurieren Sie als Nächstes einen Relying Party Trust mithilfe der Lucid-Metadaten.

Hinweis: Befolgen Sie diese genauen Anweisungen, unabhängig davon, ob Sie Lucidchart, Lucidspark oder beide verwenden.

Wählen Sie auf der Lucid-SAML-Seite Metadaten herunterladen aus , um die Lucid-Metadaten herunterzuladen.
Speichern Sie die Metadaten an einem Ort, auf den der ADFS-Server zugreifen kann.
Öffnen Sie ADFS und klicken Sie mit der rechten Maustaste auf Relying Party Trust.
Wählen Sie im Menü die Option „Relying Party Trust hinzufügen“ aus , um den Assistenten zum Hinzufügen von Relying Party Trust zu öffnen.
Klicken Sie sich durch die Eingabeaufforderungen auf dem Willkommensbildschirm.
Wählen Sie im Bildschirm „Datenquelle auswählen“ die Option „Daten über die vertrauende Seite aus einer Datei importieren“aus.
Wählen Sie „Durchsuchen“ und suchen Sie die Lucid-Metadatendatei.
Vervollständigen Sie die verbleibenden Einstellungen entsprechend den Präferenzen Ihrer Organisation.
Öffnen Sie die Endpoints-Konfiguration für Ihre Lucid-Relying-Party-Vertrauensstellung.
- Sie müssen einen weiteren Endpunkt hinzufügen, um die Speicherung der eingehenden Anmelde-URL durch ADFS anhand der bereitgestellten ACS-/Antwort-URL zu ermöglichen. Die Einstellungen sollten sein:
  - Typ = SAML-Konsumentenbehauptung
  - Bindung = POST
  - Index = 1
  - Vertrauenswürdige URL = https://www.lucidchart.com/saml/sso/ IDP Entity ID
  - Sobald Sie fertig sind, sieht die Konfiguration folgendermaßen aus:
Klicken Sie mit der rechten Maustaste auf den Lucid Relying Party Trust und wählen Sie Anspruchsregeln bearbeitenaus.
Fügen Sie mithilfe von LDAP eine Anspruchsregel hinzu und konfigurieren Sie die Anspruchsregel so, dass sie mit den unten gezeigten Attributen und Anspruchstypen übereinstimmt.
Klicken Sie auf Fertig stellen.

Jetzt haben Sie die ADFS-SAML-Integration in Lucid abgeschlossen und Ihr Lucid-Konto unterstützt die SAML-Single-Sign-On-Authentifizierung über ADFS.

Fehlerbehebung: ADFS-Integration eingerichtet

Ungültige SAML-Antwort

Dieser Fehler korrespondiert mit einer falschen SAML-Antwort des IDP. Er bedeutet normalerweise, dass der Hash-Algorithmus im ADFS von "SHA-1" auf "SHA-256" umgestellt werden muss. Navigieren Sie zum Lucid Relying Party Trust, klicken Sie mit der rechten Maustaste, und wählen Sie "Eigenschaften". Klicken Sie auf die Registerkarte "Erweitert" und schalten Sie den Hash-Algorithmus von "SHA-1" auf "SHA-256" um.

SAML wurde für Ihr Team nicht konfiguriert. Fordern Sie eine Einladung von einem für SAML aktivierten Team an.

Dieser Fehler erscheint, wenn ein Benutzer, der versucht, sich über SAML anzumelden, nicht mit dem SAML-aktivierten Team verbunden ist. Der Admin muss eine Einladung an den Benutzer senden, um in das Team aufgenommen zu werden. Wählen Sie im Lucid Admin Panel "Benutzer". Klicken Sie auf "+Benutzer" in der oberen rechten Ecke und geben Sie die E-Mail des Benutzers ein.

Ungültiges Identitätsattribut

Dieser Fehler zeigt an, dass in der SAML-Antwort ein ungültiges Identitätsattribut empfangen wurde. Konfigurieren Sie ein Claim-Attribut für den Lucid Relying Party Trust, wobei "E-Mail-Adressen" mit "Namens-ID" in ADFS übereinstimmt.

XML konnte nicht geparst werden

Diese Fehlermeldung zeigt eine fehlerhafte Syntax in den XML-Metdaten des Identity Providers an. Dies kann passieren, wenn Metadaten über ein Internet-Explorer-Fenster heruntergeladen werden. Internet Explorer fügt Gedankenstriche in die XML-Tags zum Auf- und Zuklappen ein. Sie können dieses Problem beheben, indem Sie entweder die XML-Daten in einem Texteditor öffnen oder alle Gedankenstriche im kopierten XML-Text löschen.

Erstellung von Nutzern benutzername_12345@beispiel.com

Die Lucid SAML-Integration akzeptiert 3 Attribute: Vorname, Nachname und E-Mail-Adresse. Wenn eine ungültige E-Mail-Adresse vom SAML-Identitätsprovider übergeben wird, wird eine gültige E-Mail generiert, um den Benutzer anzulegen: "Übergebener Wert" + "SAML-ID" + "@beispiel.com". Dies tritt häufig auf, wenn ein Benutzername oder Vorname anstelle der gültigen E-Mail-Adresse an das E-Mail-Adressen-Attribut übergeben wird. Sie können dieses Problem lösen, indem Sie Ihre Anspruchsregel so konfigurieren, dass eine gültige E-Mail-Adresse im Attribut E-Mail-Adresse gesendet wird.

ADFS schickt keine Antwort an Lucid

Überprüfen Sie die Endpunkte, um sicherzustellen, dass Sie die in den ADFS-Einrichtungsschritten aufgeführten Schritte befolgt haben. Wenn Sie nur einen einzigen Endpunkt haben oder Ihren www.-Endpunkt vor Ihrem app. Endpunkt indiziert haben, wird die Antwort nicht zu Lucid zurückkehren.

Verwandte Beiträge