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.
Verfügbarkeit des Tarifs: Nur Enterprise .
- Verfügbar auf FedRAMP-Konten .
- Lesen Sie den Artikel „Lucid-Pläne“ , um mehr über die in Ihrem Konto verfügbaren Funktionen zu erfahren, oder den Artikel „Lucid-Konto aktualisieren“, um Anweisungen zum Upgrade zu erhalten.
Laden Sie die Föderationsmetadaten herunter und importieren Sie sie in Lucid
-
Laden Sie die Metadaten der Föderation herunter.
-
Die Föderationsmetadaten können auf dem ADFS-Server unter folgender URL abgerufen werden, wobei [myserver.domain] ersetzt wird, um Ihre ADFS-Server-URL wiederzugeben:
https://[myserver.domain].com/FederationMetadata/2007-06/FederationMetadata.xml
-
Die Föderationsmetadaten können auf dem ADFS-Server unter folgender URL abgerufen werden, wobei [myserver.domain] ersetzt wird, um Ihre ADFS-Server-URL wiederzugeben:
- Navigieren Sie zum Admin-Panel von Lucid.
- Wählen Sie die Registerkarte App-Integration .
- Wählen Sie im Dropdown-Menü „App-Integration“ die Option „Allgemein“aus.
- Klicken Sie in der Integrationskachel „SAML“ auf Einstellungen .
-
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, an dem der ADFS-Server zugänglich ist.
- Öffnen Sie ADFS und klicken Sie mit der rechten Maustaste auf Relying Party Trust.
-
Wähle im Menü "Vertrauensperson der Partei hinzufügen ", um den Wizard "Vertrauenspartei hinzufügen" 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.
-
Füllen Sie die verbleibenden Einstellungen basierend auf den Vorlieben Ihrer Organisation aus.
-
Öffnen Sie die Endpunktkonfiguration für Ihre Lucid-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-Entitäts-ID
- Sobald Sie fertig sind, sieht die Konfiguration folgendermaßen aus:
-
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:
- Klicken Sie mit der rechten Maustaste auf den Lucid Relying Party Trust und wählen Sie Anspruchsregeln bearbeitenaus.
-
Fügen Sie eine Claim-Regel mit LDAP hinzu und konfigurieren Sie die Claim-Regel so, dass sie den unten gezeigten Attributen und Claim-Typen entspricht.
- Klicken Sie auf Fertigstellen.
Jetzt haben Sie die ADFS-SAML-Integration in Lucid abgeschlossen und Ihr Lucid-Konto unterstützt die SAML-Single-Sign-On-Authentifizierung über ADFS.
Sie haben die Möglichkeit, verschlüsselte Assertions für die Identitätsanbieter zu verwenden, die Sie Ihrem Lucid-Konto für SAML hinzufügen. Weitere Informationen finden Sie in unserem SAML-Übersichtsartikel.
Ich brauche immer noch Hilfe
Fehlerbehebung
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.
Geben Sie Feedback zu diesem Artikel
Haben Sie Feedback zu diesem Artikel? Berichten Sie uns hier von Ihren Erfahrungen.