SSO für Bluebeam-Konten konfigurieren | Okta Workforce Identity Cloud

Single Sign-On (SSO) bietet Ihren Benutzern nahtlosen Zugriff, indem es ihnen ermöglicht, mit ihren IdP-Anmeldedaten auf Bluebeam-Produkte zuzugreifen. Dieser Leitfaden enthält Anweisungen für den IT Admin zur Konfiguration von SSO für ihr Unternehmen, wenn sie Okta Workforce Identity Cloud als Identitätsanbieter (IdP) verwenden. Wenn Sie Microsoft Entra ID als IdP verwenden, finden Sie weitere Informationen unter Konfigurieren von SSO für Bluebeam Konten | Entra ID.

Wenn Sie einen anderen IdP als Entra ID oder Okta Workforce Identity Cloud verwenden, finden Sie weitere Informationen zur SSO-Konfiguration für nicht unterstützte, aber kompatible IdPs unter SSO konfigurieren für Bluebeam-Konten | Generisches OIDC.

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.
• Verwendet Microsoft Entra ID oder Okta Workforce Identity Cloud als Identitätsanbieter (IdP).
  

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

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

   • US app.bluebeam.com/org-admin
   • 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.

   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.

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

5. Geben Sie die angeforderten Informationen an.

Nachdem wir Ihre Anfrage erhalten und bearbeitet haben, können Sie mit der SSO-Konfiguration fortfahren. Wenn Sie Ich möchte SCIM verwenden ausgewählt haben, wird sich der Bluebeam-Support mit Ihnen in Verbindung setzen, um Ihnen mitzuteilen, ob Sie mit der SCIM-Aktivierung fortfahren können oder ob weitere Maßnahmen erforderlich sind.

Überblick

Dieser Leitfaden enthält die Konfiguration von SSO für den Zugriff auf die Produkte und Dienste von Bluebeam sowie die Informationen, die zwischen Bluebeam und Ihrem IdP ausgetauscht werden müssen.

Die SSO-Konfiguration sollte von dem IT-Administrator Ihrer Organisation durchgeführt werden.

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.

Sie können nicht mit der SSO-Konfiguration beginnen, während der Domain-Status „Ausstehend“ ist, müssen aber nicht warten, bis die Domain verifiziert wurde, um weitere Domains anfordern zu können.

Der Domain-Status kann bis zu 72 Stunden lang „Ausstehend“ bleiben, während die DNS-Weitergabe dieser Änderungen an alle Server im Internet erfolgt. Während dieser Zeit können Sie sich regelmäßig bei Org Admin anmelden und folgendermaßen vorgehen, um zu überprüfen, ob der Status zu „Überprüft“ geändert wurde.

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 auf der Seite „Domain-Eigentümerschaft“ die drei Punkte unter „Aktionen“ aus und wählen Sie dann „Verifizierung überprüfen“ aus.

Wenn der Status der Domain nach 72 Stunden immer noch „Ausstehend“ lautet, überprüfen Sie zunächst, ob Sie die Informationen korrekt in den TXT-Eintrag eingegeben haben. Wenn der TXT-Eintrag korrekt ist, kontaktieren Sie uns bitte.

Konfigurieren Sie SSO

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

• Konfiguration von OIDC in Okta

• Erstellen Sie eine Okta-Anwendung für SSO

• Exportieren Sie die Benutzerliste und bereiten Sie den Abgleich der Benutzer vor

• Konfigurieren Sie SSO in der Unternehmensadministration

Konfiguration von OIDC für Okta

Gehen Sie folgendermaßen vor, um OIDC in Okta zu konfigurieren:

1. Gehen Sie in der Okta-Administratorkonsole zu Sicherheit > API und bearbeiten Sie den Standard-Autorisierungsserver.

2. Wählen Sie unter „Zugriffsrichtlinien“die Option „Richtlinie hinzufügen“ aus und geben Sie folgende Werte an:

   • Name: Standard
   • Beschreibung: Standard
   • Zuweisen zu: Wählen Sie alle Clients aus

3. Wählen Sie „Richtlinie erstellen“ aus.

4. Wählen Sie in der von Ihnen erstellten Richtlinie die Option „Regel hinzufügen“ aus.

5. Geben Sie auf der Seite „ Regel hinzufügen“ „Standard“ als Namen der Regel ein und behalten Sie alle anderen Auswahlen bei.

6. Wählen Sie „Regel erstellen“ aus.

Erstellen Sie eine Okta-Anwendung für SSO und erfassen Sie Informationen für die SSO-Konfiguration

Gehen Sie folgendermaßen vor, um eine Okta-Anwendung für SSO zu erstellen:

1. Gehen Sie in der Okta-Administratorkonsole zu Anwendungen > Anwendungen > + App-Integration erstellen.

2. Legen Sie auf der Seite „Create a new app integration“ (Neue Anwendungsintegration erstellen) Folgendes fest:

   • Anmeldemethode: OIDC – OpenID Connect

   • Anwendungstyp: Webanwendung

3. Wähle Weiter.

4. Führen Sie auf der Seite „Integration einer neuen Web-App“ die folgenden Aktionen aus:

   • Geben Sie einen Namen für die App-Integration für Ihre OIDC-SSO-Anwendung ein.

   • Wählen Sie „Autorisierungscode“ als Genehmigungstyp aus.

   • Fügen Sie die folgenden Anmeldeumleitungs-URIs hinzu:

     • 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

     Entfernen Sie den Standardeintrag (http://localhost:8080/authorization-code/callback) nicht aus der Liste.

   • Unter „Zuweisungen“:

     • Wählen Sie „Allen in Ihrer Organisation Zugriff“ aus.

     • Wählen Sie „Sofortigen Zugriff im Federation-Explorer-Modus aktivieren“ aus.

5. Wähle Speichern aus.

6. Um die Benutzerauthentifizierung zu konfigurieren, gehen Sie zur Registerkarte „Anmelden“ für die Anwendung.

7. Scrollen Sie zu „Benutzerauthentifizierung“ und wählen Sie eine Autorisierungsmethode aus.

8. Wähle Speichern aus.

Um Informationen zu erfassen, die Sie für die SSO-Konfiguration benötigen, gehen Sie folgendermaßen vor:

1. Wählen Sie die Registerkarte „Allgemein“ aus, kopieren Sie die folgenden Informationen und fügen Sie sie an einer anderen Stelle ein, um sie bei der SSO-Konfiguration zu verwenden:

   • Client-ID

   • Clientschlüssel

2. Gehen Sie in der Seitennavigation zu Sicherheit > API und wählen Sie den Standardautorisierungsserver aus.

3. Auf der Einstellungsseite:

   1. Kopieren Sie den Metadaten-URI-Wert und fügen Sie ihn in einen Texteditor ein.

   2. Ersetzen Sie "oauth-authorization-server" in der URL durch "openid-configuration".
      

4. Kopieren Sie die aktualisierte URL und fügen Sie sie in Ihren Webbrowser ein, um Informationen anzuzeigen, die Sie später für die SSO-Konfiguration benötigen werden.

   Sie können eine Browsererweiterung „Pretty Print“ verwenden, um den Inhalt des Metadaten-URI besser anzuzeigen und die für die SSO-Konfiguration benötigten Informationen leichter zu finden.

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

Im Rahmen der SSO-Konfiguration werden Sie aufgefordert, die Benutzer in Ihrer Organisation, die in Ihrem IdP aufgeführt sind, mit der Liste der Benutzer abzugleichen, die Bluebeam-IDs (BBIDs) besitzen. Verwenden Sie dieses Verfahren, um Ihre Benutzerliste zu exportieren und sie in unsere CSV-Vorlage für den SSO-Abgleichsprozess zu laden.

1. Exportieren Sie Ihre Benutzerliste aus Okta Workforce Identity Cloud gemäß deren Anweisungen.
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.
   
   

   Okta Workforce Identity Cloud FELDNAME	CSV-Vorlage entsprechende Spalte
   Nachname	lastName
   Vorname	firstName
   Primäre E-Mail-Adresse	email

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 die Schritte a und b für keinen Benutzer 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 Endnutzer in Ihrer Organisation ein, die bei Ihrem IdP aufgeführt sind. Außerdem gleichen Sie die Liste Ihrer Nutzer in Okta Workforce Identity Cloud mit der Liste Ihrer Nutzer in unserem System ab, die BBIDs besitzen, um sicherzustellen, dass die Okta-Nutzer-IDs Ihrer Endnutzer mit ihren 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. angezeigt beim Einfügen der Metadaten-URI früher in Ihrem Webbrowser: 
   • Aussteller
   • Autorisierungsendpunkt
   • Tokenendpunkt
   • JWKS-URI
   • Userinfo-Endpunkt (erforderlich für Okta)
   • 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 die Standardeinträge für "Service-Anbieter-Attribut den verfügbaren Feldern zuordnen" bei.
9. Wählen Sie Anmelden, um SSO zu testen aus.
10. Wenn Sie dazu aufgefordert werden, melden Sie sich mit einem Konto an, das eine Studio BBID besitzt.
    Die Tests „Verbindung“ und „Benutzerattribute“ müssen erfolgreich verlaufen sein, bevor Sie fortfahren können.
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 BBIDs, die wir in Ihrer Organisation finden, mit den Nutzer-IDs für Ihre Organisation in Okta Workforce Identity Cloud 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 Okta Workforce Identity Cloud mit den BBIDs in der Bluebeam -Benutzerdatenbank für die Benutzer in Ihrer Organisation übereinstimmen. Wenn Sie die SSO-Konfiguration fortsetzen, ohne den Abgleich durchzuführen, verlieren nicht zugeordnete Nutzer den Zugriff auf ihre bestehenden Studio-Projekte und Sessions.

Wenn die E-Mail „SSO-Konfiguration fortsetzen“ eintrifft, öffnen Sie diese und wählen Sie „SSO-Konfiguration fortsetzen“aus, um Org Admin auf der Seite „Einstellungen“ zu öffnen. 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.

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

Nutzer können aus verschiedenen Gründen als „Nicht zugeordnet“ aufgeführt werden. Zum Beispiel, die Liste der von uns gespeicherten BBIDs könnte Nutzer umfassen, die entweder nicht mehr in Ihrer Organisation tätig sind, deren Name sich geändert hat oder deren E-Mail-Adressen beim ursprünglichen Hinzufügen falsch angegeben wurden. Mithilfe der Abstimmung können Sie die Nutzer bewerten, die als „Nicht abgeglichen“ aufgeführt sind, um festzustellen, ob sie für SSO-Zugriff eingerichtet werden sollten oder ob der Konfigurationsprozess diese Nutzer ignorieren kann.

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 eine oder mehrere Benutzer:innen aus, die ignoriert und nicht für SSO konfiguriert werden sollen, da sie entweder nicht mehr in Ihrem Unternehmen sind oder keinen Subscription Zugriff auf Produkte und Services von Bluebeam benötigen.
• Wählen Sie mindestens eine Benutzer:in aus,um das Feld „Neue Bluebeam ID aus Verzeichnis“ zu aktualisieren. Diese Aktion ist erforderlich, wenn Benutzer:innen, die Subscription Zugriff auf Produkte und Services von Bluebeam benötigen, ihre E-Mail-Adressen mit Ihrem Unternehmen geändert haben, ihre BBID in unserer Datenbank jedoch nicht geändert wurde.

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
• Sitzung besucht
• 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 muss die neue Bluebeam-ID aus dem Verzeichnis bearbeitet werden?

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 zugeordnete Nutzer ignorieren oder aktualisieren, wählen Sie Aktivieren, um die SSO-Konfiguration abzuschließen. Wenn Sie mit der SCIM-Konfiguration für Ihr Unternehmen fortfahren möchten, finden Sie weitere Informationen unter SCIM für Bluebeam -Konten konfigurieren.

SSO deaktivieren

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

Falls Sie SCIM für Ihr Unternehmen konfiguriert haben, können Sie SCIM deaktivieren und SSO konfiguriert lassen. Wenn Sie jedoch SSO deaktivieren möchten, müssen Sie zuerst SCIM deaktivieren.