Konfigurieren von SSO für Bluebeam Konten | OIDC

Single Sign-On (SSO) bietet Ihren Benutzern nahtlosen Zugriff, indem es ihnen ermöglicht, mit ihren IdP-Anmeldedaten auf Bluebeam-Produkte zuzugreifen.

Bluebeam unterstützt offiziell die SSO-Konfiguration für die folgenden IdPs:

• Microsoft Entra ID: Wenn Sie Microsoft Entra ID als Identitätsanbieter verwenden, finden Sie weitere Informationen unter Konfigurieren von SSO für Bluebeam-Konten | Entra ID.

• Okta Workforce Identity Cloud: Wenn Sie Okta Workforce Identity Cloud als IdP verwenden, finden Sie weitere Informationen unter SSO für Bluebeam Konten konfigurieren | Okta Workforce Cloud.

Revu ist mit anderen IdPs kompatibel, die OpenID Connect (OIDC) als Authentifizierungsprotokoll verwenden. Diese Konfigurationen werden jedoch nicht unterstützt, und die SCIM-Aktivierung ist nicht verfügbar. Dieses Dokument enthält einfache Anweisungen zur Verwendung unseres generischen OIDC-Connectors zur Konfiguration von SSO für einen kompatiblen, jedoch nicht unterstützten IdP, jedoch kann der Bluebeam-Support. Der Bluebeam-Support kann keine Fehlerbehebung durchführen, wenn Sie Probleme bei der Konfiguration von SSO für einen nicht unterstützten IdP haben, und Sie müssen SSO möglicherweise deaktivieren.

Anforderungen

Die Möglichkeit zur Konfiguration von SSO ist nur für Ihr Unternehmen verfügbar:

• Hat mindestens 10 Lizenzen für ein Bluebeam-Abonnement gekauft oder in ein solches umgewandelt.
• Ist noch nicht für die Verwendung von SSO mit Produkten und Services von Bluebeam konfiguriert. Wenn SSO in Ihrem Unternehmen bereits konfiguriert ist, kontaktieren Sie uns, bevor Sie fortfahren.

Wenn Sie diese Anforderungen erfüllen und SSO für Ihr Unternehmen aktivieren möchten, muss der Org Admin die folgenden Schritte ausführen, um Zugriff zur Konfiguration von SSO anzufordern:

1. Geben Sie in Ihrem Webbrowser die Org Admin-URL ein, die Ihrer Region entspricht:

   • US app.bluebeam.com/org-admin
   • CA app.bluebeam.ca/org-admin/home
   • SE app.bluebeam.se/org-admin
   • DE app.bluebeam.de/org-admin
   • AUS app.bluebeam.com.au/org-admin

   • UK app.bluebeam.co.uk/org-admin

2. Wählen Sie unter „Konten“ das Konto aus, das Sie verwalten möchten.

3. Gehen Sie zu Einstellungen.

4. Wählen Sie neben der SSO-Konfiguration die Option „Zugriff anfordern“ aus.

   Wenn Ihr Unternehmen die Anforderungen für die SSO-Konfiguration nicht erfüllt, ist die Schaltfläche Zugriff anfordern nicht verfügbar und Sie können nicht fortfahren.

5. Geben Sie die angeforderten Informationen an.

Nachdem wir Ihre Anfrage erhalten und bearbeitet haben, können Sie mit der SSO-Konfiguration fortfahren.

Beanspruchen Sie Domains und verifizieren Sie sie

Um SSO zu konfigurieren, beanspruchen Sie zunächst die Domain, die Ihrer Organisation gehört und die Sie mit Ihrem Bluebeam-Konto verknüpfen möchten, und bestätigen Sie diese dann. Um mehr als eine Domain mit Ihrem Bluebeam-Konto zu verknüpfen, führen Sie dieses Verfahren für jede dieser Domains separat durch. Sie können SSO erst konfigurieren, wenn Sie mindestens eine Domain beansprucht und bestätigt haben.

Bei diesem Verfahren müssen Sie Informationen aus dem Unternehmensadministrator kopieren und in einen neuen TXT-Eintrag für Ihren DNS-Server einfügen. Sie sollten sich darauf vorbereiten, sich für jede Domain, die Sie beanspruchen möchten, beim DNS-Server anzumelden, um sich auf diesen Schritt vorzubereiten.

Gehen Sie folgendermaßen vor, um Ihre Domain zu beanspruchen und zu verifizieren:

1. Wählen Sie unter „Unternehmensadministrator“ die Option „Konten“ aus und wählen Sie dann das Konto aus, das Sie verwalten möchten.
2. Wählen Sie „Einstellungen“ aus.
3. Wählen Sie neben „Domaineigentümerschaft“ die Option „Verwalten“ aus.
4. Wählen Sie „Domain beanspruchen“ aus.
5. Geben Sie den Domain-Namen ein, den Sie beanspruchen möchten (z. B Company.com) und und wählen Sie „Anspruch“ aus.
6. Wählen Sie im Dialogfeld „Domain verifizieren“ neben jedem Feld die Option Kopieren aus und fügen Sie die Informationen in einen neuen TXT-Eintrag für Ihren DNS-Server ein.
7. Warten Sie mindestens fünf Minuten und wählen Sie dann die Option „Verifizierung prüfen“ aus.

Führen Sie dieses Verfahren für jede Domain aus, die Sie beanspruchen und verifizieren möchten.

Konfigurieren Sie SSO

Für die SSO-Konfiguration müssen Sie eine Reihe von Verfahren bei Ihrem IdP ausführen, bevor Sie die Konfiguration in Org Admin abschließen.

1. Erstellen Sie eine Anwendung für SSO in Ihrem IdP

2. Exportieren Sie die Benutzerliste und bereiten Sie den Abgleich der Benutzer vor

3. Konfigurieren Sie SSO in der Unternehmensadministration

4. Gleichen Sie die Nutzeridentitäten in Ihrem IdP mit Bluebeam IDs in Ihrer Organisation ab

Erstellen Sie eine Webanwendung für SSO und erfassen Sie Informationen für die SSO-Konfiguration.

Um SSO für Ihr Bluebeam-Konto zu konfigurieren, müssen Sie bei Ihrem IdP eine Anwendung dafür erstellen. In diesem Abschnitt werden der allgemeine Arbeitsablauf und die Informationen beschrieben, die Sie zum Erstellen der Anwendung benötigen. Ausführliche Informationen zum Erstellen einer SSO-Anwendung in Ihrem IdP finden Sie in der Dokumentation Ihres IdP.

Generell sollten Sie Folgendes bereithalten:

• Wenn die Konfigurationsoptionen angezeigt werden, wählen Sie die Option für OIDC.

• Wenn Sie dazu aufgefordert werden, geben Sie die folgenden Anmelde-Umleitungs-URIs an:

  • https://signin.bluebeam.com/oauth2/v1/authorize/callback

  • https://id.bluebeam.com/oidc/callback

  • https://signin.bluebeamstudio.co.uk/oauth2/v1/authorize/callback

  • https://signin.bluebeamstudio.de/oauth2/v1/authorize/callback

  • https://signin.bluebeamstudio.se/oauth2/v1/authorize/callback

  • https://signin.bluebeamstudio.com.au/oauth2/v1/authorize/callback

  • https://id.bluebeam.com/oidctest/callback

• Wenn Sie zur Eingabe der erforderlichen Benutzerattribute aufgefordert werden, verwenden Sie Folgendes:

  • family_name

  • given_name

  • email

  • Preferred_Username

• Stellen Sie sicher, dass die Anwendung für alle vom IdP verwalteten Benutzer zugänglich ist.

Gehen Sie wie folgt vor, um die für die SSO-Konfiguration in Org Admin erforderlichen Informationen zu erfassen:

1. Suchen Sie die folgenden Informationen in Ihrem IdP und kopieren Sie sie an einen anderen Ort, um sie während der SSO-Konfiguration zu verwenden:

   • Aussteller-URI

   • Autorisierungsendpunkt-URI

   • JWKS-URI

   • Anwendungs-ID (Client-ID)

   • Clientschlüssel

   • Tokenendpunkt

   • Userinfo-Endpunkt

2. Wählen Sie in Ihrem IdP den Standard-Autorisierungsserver aus.

Exportieren Sie eine Benutzerliste von Ihrem IdP und bereiten Sie den Abgleich der Benutzer vor

Im Rahmen der SSO-Konfiguration werden Sie aufgefordert, die Nutzer in Ihrer Organisation, die in Ihrem IdP aufgeführt sind, mit der Liste der Nutzer in Ihrer Organisation abzugleichen, die Bluebeam IDs (BBIDs) besitzen .

Der Abgleich stellt sicher, dass die Benutzeridentitäten in Ihrem IdP mit den BBIDs in der Bluebeam -Benutzerdatenbank für die Benutzer in Ihrer Organisation übereinstimmen. Wenn Nutzer in Ihrer Organisation ihre eigenen BBIDs und Kennwörter ausgewählt haben, bevor Sie mit der SSO-Implementierung begonnen haben, verwenden sie möglicherweise eine E-Mail-Adresse als BBID, die nicht mit der E-Mail-Adresse übereinstimmt, die Sie als Zuordnungswert in Ihrem IdP ausgewählt haben.

Verwenden Sie das folgende Verfahren, um Ihre Nutzerliste zu exportieren und sie in unsere CSV-Vorlage für den SSO-Abgleichsprozess zu laden:

1. Exportieren Sie Ihre Liste gemäß den Anweisungen Ihres IdP.
2. Öffnen Sie die exportierte Benutzerliste.
3. Laden Sie unsere CSV-Vorlage herunter und öffnen Sie sie.
4. Kopieren Sie die erforderlichen Benutzerinformationen aus der exportierten Benutzerliste in die definierten Zellen unserer Vorlage.
   
   

   Attributübernahme	CSV-Vorlage entsprechende Spalte
   family_name	lastName
   given_name	firstName
   E-Mail oder preferred_username	email

   Wenn Sie SSO für die E-Mail-Adresse Ihrer Benutzer konfigurieren, stellen Sie sicher, dass Sie den Wert, den Ihr IdP als E-Mail-Anspruch der Benutzer sendet, in die Spalte „email“ in unserer CSV-Vorlage kopieren.

   Wenn Sie SSO für den preferred_username Ihrer Nutzer konfigurieren, stellen Sie sicher, dass Sie die Werte kopieren, die Ihr IdP als preferred_username-Claim der Nutzer sendet, und zwar in die Spalte „email“ in unserer CSV-Vorlage.

5. Suchen Sie in der Datei nach Zeilen, die leere Zellen enthalten, ermitteln Sie, ob diese Benutzer BBIDs benötigen, und führen Sie folgende Aktionen aus:
   
   • Wenn die leere Zelle in einer Zeile für einen Benutzer erscheint, der keine BBID benötigt, können Sie die Zeile löschen.
   • Wenn die leere Zelle in einer Zeile für einen Benutzer erscheint, der eine BBID benötigt:
     
     1. Suchen Sie den entsprechenden Eintrag in Ihrem IdP und geben Sie den fehlenden Wert an.
     2. Exportieren Sie Ihre Benutzerliste erneut von Ihrem IdP und fahren Sie mit dem 4. Schritt fort.
     Falls Sie diese Teilschritte für keinen Nutzer ausführen mussten, fahren Sie mit Schritt 6 fort.
6. Speichern Sie die CSV-Datei, um sie bei der Konfiguration von SSO in der Unternehmensadministration zu verwenden.

Konfigurieren Sie SSO in der Unternehmensadministration

Um die SSO-Konfiguration abzuschließen, richten Sie den SSO-Zugriff auf Bluebeam Produkte und -Dienste für Endbenutzer in Ihrer Organisation ein, die bei Ihrem IdP aufgeführt sind. Außerdem gleichen Sie die Liste Ihrer Benutzer in Ihrem IdP mit der Liste Ihrer Benutzer in unserem System ab, die über BBIDs verfügen, um sicherzustellen, dass die IDs Ihrer Endbenutzer in Ihrem IdP mit den BBIDs übereinstimmen.

Melden Sie sich beim Org Admin an und befolgen Sie die folgenden Schritte, um SSO zu konfigurieren:

1. Wählen Sie unter „Konten“ das Konto aus, das Sie verwalten möchten.

2. Gehen Sie zu Einstellungen.

3. Wählen Sie neben der SSO-Konfiguration die Option „Konfigurieren“ aus.
4. Wählen Sie OpenID Connect aus.
   
5. Geben Sie bei Aufforderung die folgenden angeforderten Informationen an. die Sie zuvor von Ihrer SSO-Anwendung erfasst haben: 
   • Aussteller
   • Autorisierungsendpunkt
   • Tokenendpunkt
   • JWKS-URI
   • Userinfo-Endpunkt
   • Client-ID
   • Clientschlüssel
6. Wählen Sie „Absenden“ aus.
7. Geben Sie im Dialogfenster „OpenID Connect-Konfiguration“ die verifizierte Domain(s) an, die für Ihr Konto konfiguriert werden soll(en), und wählen Sie „Weiter“ aus.
8. Behalten Sie bei „Dienstanbieter-Attribut verfügbaren Feldern zuordnen„ die Standardeinträge für Vorname und Nachname bei. Wählen Sie für E-Mail-Zuordnung email aus, oder wählen Sie preferred_username aus, wenn Sie eine Zuordnung zu preferred_username vornehmen möchten.
9. Wählen Sie Anmelden, um SSO zu testen aus.
10. Verwenden Sie bei entsprechender Aufforderung ein Konto mit einer Studio - BBID für die Anmeldung.
    Die Tests „Verbindung“ und „Benutzerattribute“ müssen erfolgreich verlaufen sein, bevor Sie fortfahren können. Überprüfen Sie, ob die für „Benutzerattribute“ erwarteten Werte mit Ihrer Auswahl für die Zuordnung übereinstimmen.
11. Kehren Sie zum Unternehmensadministrator zurück.
12. Wählen Sie „Weiter“ aus.
13. Wählen Sie Weiter, um eine Liste Ihrer Nutzer anzugeben und die SSO-Konfiguration abzuschließen.

14. Laden Sie die CSV-Datei hoch, die Sie zuvor erstellt haben.

15. Klicken Sie auf „Weiter“.

    Wählen Sie „Später abschließen“ aus, um Ihren Fortschritt zu speichern, verlassen Sie dieses Verfahren und setzen Sie es zu einem späteren Zeitpunkt fort.
16. Wenn Sie dazu aufgefordert werden, wählen Sie Schließen, um die SSO-Konfiguration fortzusetzen.

Sie kehren zur Registerkarte Einstellungen zurück, auf der Sie überprüfen können, ob die für Ihre Organisation ausgewählten Domänen angezeigt werden, und anschließend mit der SSO-Konfiguration fortfahren können.

Wir gleichen die BBIDs, die wir in Ihrer Organisation finden, mit den Benutzer-IDs für Ihre Organisation in Ihrem IdP ab. Wir senden Ihnen eine E-Mail mit dem Betreff „SSO-Konfiguration fortsetzen“, sobald dieser Vorgang abgeschlossen ist. Anschließend können Sie mit dem Abgleichprozess beginnen, der für den Abschluss der SSO-Konfiguration erforderlich ist.

Gleichen Sie die Benutzeridentitäten Ihres IdP mit den BBIDs in Ihrem Unternehmen ab

Der Abgleich stellt sicher, dass die Benutzeridentitäten in Ihrem IdP mit den BBIDs in der Bluebeam -Benutzerdatenbank für die Benutzer in Ihrer Organisation übereinstimmen. Wenn Nutzer in Ihrer Organisation ihre eigenen BBIDs und Kennwörter ausgewählt haben, bevor Sie mit der SSO-Implementierung begonnen haben, verwenden sie möglicherweise eine E-Mail-Adresse als BBID, die nicht mit der E-Mail-Adresse übereinstimmt, die Sie als Zuordnungswert in Ihrem IdP ausgewählt haben.

Reconciliation konzentriert sich auf die Studio -Daten der Nutzer. Wenn Sie die SSO-Konfiguration fortsetzen, ohne den Abgleich durchzuführen, verlieren diese nicht zugeordneten Nutzer den Zugriff auf ihre bestehenden Studio-Projekte und Sessions. Nicht zugeordnete Nutzer verlieren insbesondere den Zugriff auf Folgendes:

• Aktive Studio-Sitzungen oder Studio-Projekte in ihrem Besitz

• Markierungen, die in aktiven Studio-Sitzungenihnen gehören

Wenn die E-Mail „SSO-Konfiguration fortsetzen“ eintrifft, öffnen Sie diese und führen Sie die folgenden Schritte aus:

1. Wählen Sie „SSO-Konfiguration fortsetzen“ aus, um Org Admin auf der Seite „Einstellungen“ zu öffnen.

2. Klicken Sie neben „SSO-Konfiguration“ auf Weiter, um eine Liste der Nutzer in Ihrem Konto anzuzeigen, zu denen wir keine passenden Nutzer in unserer Datenbank finden konnten.

3. Aktualisieren oder ignorieren Sie Nutzerinformationen, die als „Nicht zugeordnet“ angezeigt werden.

Die Liste „Nicht zugeordnet“ umfasst nicht zugeordnete Nutzer, die in den vergangenen sechs Monaten auf Studio zugegriffen haben. Die Liste ist nach „Letzte Studio -Anmeldung“ sortiert, wodurch Sie diejenigen Nutzer priorisieren können, bei denen am ehesten eine Zuordnung erforderlich ist. Der Rest dieses Abschnitts befasst sich mit Fragen zu Nutzern auf der Liste und beschreibt die Aktionen, die Sie zum Abschließen der Zuordnung ausführen können.

Warum werden einige Benutzer als „Nicht übereinstimmen“ aufgeführt?

Nachdem beim Abgleich die Benutzeridentitäten von Ihrem IdP mit denen in der Bluebeam -Datenbank verglichen wurden, werden einige möglicherweise als „Nicht zugeordnet“ aufgeführt. Nutzer können aus verschiedenen Gründen als nicht zugeordnet aufgeführt werden, darunter die folgenden:

• Der Nutzer gehört nicht mehr zu Ihrer Organisation.

• Der Nutzer hat seine E-Mail-Adresse in Ihrem IdP geändert, dies jedoch nicht für sein Bluebeam -Konto getan.

• Die ursprüngliche E-Mail-Adresse wurde falsch eingegeben.

• Der Nutzer hat Studio -Daten, die einer älteren E-Mail-Adresse zugeordnet sind.

Die Liste der von uns gespeicherten BBIDs könnte zum Beispiel Nutzer umfassen, die entweder nicht mehr in Ihrer Organisation tätig sind, deren Name sich geändert hat oder deren E-Mail-Adresse beim ursprünglichen Hinzufügen falsch angegeben wurde. Mithilfe des Abgleichs können Sie die als „Nicht zugeordnet“ aufgeführten Nutzer überprüfen, um festzustellen, ob der SSO-Zugriff für sie eingerichtet oder ob diese Nutzer beim Konfigurationsprozess ignoriert werden sollen.

Wenn Sie diesen Bildschirm sehen, können Sie:

• Wählen Sie „Benutzerliste erneut hochladen“ aus, wenn Ihre CSV-Datei Fehler enthält, die Sie korrigieren müssen.

• Wählen Sie „Speichern und später abschließen“ aus, wenn Sie Ihren Fortschritt speichern und sich später mit den nicht übereinstimmenden Benutzern befassen möchten.

• Wählen Sie einen oder mehrere Nutzer aus, die ignoriert und nicht für SSO konfiguriert werden sollen, da sie entweder nicht mehr in Ihrer Organisation tätig sind oder keinen Zugriff auf Bluebeam -Produkte und -Dienste benötigen.

• Wählen Sie einen oder mehrere Nutzer aus, um das Feld Neue Bluebeam -ID aus Verzeichnis zu aktualisieren. Diese Maßnahme ist erforderlich , wenn ein Nutzer Abo-Zugriff auf Bluebeam -Produkte und -Dienste benötigt oder sich seine E-Mail-Informationen in Ihrer Organisation geändert haben, seine BBID in unserer Datenbank jedoch unverändert geblieben ist.

Warum erscheint ein Benutzer mehrmals?

Wenn Benutzer:innen mehrmals, aber in unterschiedlichen Studio -Regionen angezeigt werden, stimmen Sie die Benutzer:innen für jede Region ab, um sicherzustellen, dass sie den Zugriff auf diese Studio-Projekte oder Studio-Sitzungen nicht verlieren.

Wann ist „Benutzer ignorieren“ sinnvoll?

Viele nicht zugeordnete Nutzer sind entweder nicht mehr in Ihrer Organisation oder benötigen keine BBID. Wenn Sie die Liste der nicht zugeordneten Nutzer sehen, bewegen Sie den Mauszeiger über das Informationssymbol () neben der aktuellen BBID eines nicht zugeordneten Nutzers, um deren Studio-Aktivität zu überprüfen. Die angezeigten Informationen sind:

• Letzte Studio-Anmeldung
• Eigentümer von Sitzungen
• Besuchte Sitzungen
• Projekte im Besitz
• Projektmitgliedschaften

Wenn Sie feststellen, dass ein:e Benutzer:in ein ehemaliger Mitarbeiter:in ist oder aus einem anderen Grund keinen SSO-Zugriff auf die Produkte und Services von Bluebeam benötigt, wählen Sie „Nicht übereinstimmen“ aus und wählen Sie dann „Benutzer ignorieren“ aus, um den oder die Benutzer:in von der SSO-Konfiguration für Ihr Unternehmen auszuschließen.

Um mehrere Benutzer zu ignorieren, wählen Sie mehrere Benutzer aus und klicken Sie auf „Benutzer ignorieren“.

Wann das Feld „Neue Bluebeam -ID aus Verzeichnis“ bearbeitet werden sollte

Wenn ein Benutzer aktualisiert werden muss, wählen Sie Bearbeiten, dann „Nicht zugeordnet“ aus und geben Sie die E-Mail-Adresse des Benutzers vom IdP an. Nachdem Sie die übereinstimmenden Informationen aktualisiert haben, teilen Sie den oder den Benutzer:innen mit, dass sie künftig die neue BBID verwenden müssen, und melden Sie sich bei Bedarf mit der neuen BBID ab und wieder an.

Wählen Sie „Alle Benutzer anzeigen“ aus, um zu überprüfen, ob jeder Benutzer in der Liste entweder „Ignoriert“ ist oder „Keine Änderung“ anzeigt.

SSO aktivieren

Nachdem Sie nicht übereinstimmende Benutzer ignoriert oder aktualisiert haben, wählen Sie Aktivieren, um die SSO-Konfiguration abzuschließen.

SSO deaktivieren

Verwenden Sie Org Admin, wenn Sie SSO für Ihr Unternehmen deaktivieren müssen.