Einmalige Anmeldung (SSO)

Schritt 1: Subdomain in Clockify erstellen #

Für weitere Informationen darüber kannst du den Abschnitt "Benutzerdefinierte Subdomain einrichten" lesen.

Schritt 2: Anwendung in Okta erstellen #

1. Zu Anwendungen in der Seitenleiste
2. Auf die Schaltfläche "App-Integration erstellen" klicken
3. Im Modalfenster SAML 2.0 wählen
4. Auf "Weiter" klicken

SAML 2.0-Integration erstellen #

In "Allgemeine Einstellungen" solltest du die folgenden Informationen eingeben und auf "Weiter" klicken:

• App-Name:: z. B. Clockify
• Logo: Clockify-Logo hochladen

Im "SAML konfigurieren" solltest du die folgenden Informationen eingeben:

• Single-Sing-on-URL (oder ACS): bestimmte URL, zu der SAML-Assertions aus Okta gesendet werden sollen (e.g. https://global.api.clockify.me/auth/saml2)
• Audience-URL (Entity ID in deiner App): einheitlicher Bezeichner deiner benutzerdefinierten Anwendung; gleich wie die Entity-ID im SAML-Authentifizierung-Feld (z. B. https://yourcompanysubdomain.clockify.me)
• Default Relay State: IdP-initiierte Authentifizierung, damit Benutzer sich an Clockify direkt von dem Okta-Dashboard aus anmelden können

Default Relay State-Beispiel:

{"location":"https://yourcompanysubdomain.clockify.me", "organizationName":"yourcompanysubdomain"}

Du solltest sicherstellen, dass du gerade statt typografische Anführungszeichen verwendest, sonst funktioniert es nicht.

Du solltest alles andere so lassen, wie es ist und auf "Weiter" klicken.

In Feedback solltest du "Ich bin Okta-Kunde, der eine interne App hinzufügt" abhaken und auf "Abschließen" klicken.

Dein Bildschirm sollte so aussehen:

Im letzten Schritt in diesem Abschnitt solltest du auf die Schaltfläche “Anweisungen zur Einrichtung ansehen” klicken, die du im Bildschirmfoto oben sehen kannst.

Im "So wird SAML 2.0 für Clockify-Anwendung konfigurieret"erhältst du eine Liste mit Daten, die du benötigst, um deine Clockify-Anwendung zu konfigurieren.

Schritt 3: SSO-Konfiguration in Clockify hinzufügen #

Jetzt solltest du in Clockify, im Bildschirm Authentifizierung:

1. Auf SSO-Konfiguration hinzufügen unten im Bildschirm klicken
2. SAML2 als Authentifizierungstyp wählen
3. Okta als IdP-Vorlage wählen

Im Form SAML2-Authentifizierung wird angezeigt:

Die folgenden Informationen eingeben:

• Entity Id (Audience URI in Okta): e.g. https://yourcompanysubdomain.clockify.me
• Metadata Url:
  • Zu Okta zurücknavigieren
  • Identity Provider metadata-Link aus dem Abschnitt "Einstellungen" in Okta kopieren
  • Als .xml-Datei speichern und in Clockify hochladen
• SAML SSO URL: Identity Provider Single Sign-On URL aus "So wird SAML 2.0 für Clockify-Anwendung konfiguriert" für Okta kopieren und einfügen.

Zum Beispiel:

https://okta.ops.clockify.me/app/dev05335506_clockifytempsaml2_1/exk4erumfseHaalgs5d7/sso/saml

• Erweitert: X.509 Zertifikat von Oktay kopieren und einfügen

Dein Bildschirm in Clockify sollte etwa so aussehen:

und

Nach der Eingabe aller erforderlichen Daten kannst du dich entscheiden, deine Konfiguration zu testen, indem du auf die Schaltfläche Konfiguration testen klickst. Diese Aktion stellt die Genauigkeit der angegebenen Informationen sicher. Wenn alles korrekt ist, wird die Schaltfläche Konfiguration testen mit der Schaltfläche Konfiguration abschließen gewechselt.

Du solltest auf "Konfiguration abschließen" klicken, um den Vorgang abzuschließen und "Anmeldung mit SAML2" zu ermöglichen. Optional kannst du "Anmeldung mit E-Mail und Passwort" deaktivieren.

Schritt 4: Anwendung in Okta zuweisen #

In Okta:

1. Zu "Anwendung" navigieren
2. Clockify wählen
3. In der Registerkarte "Aufträge" auf "Zuweisen" klicken
4. "Personen/Gruppen zuweisen" wählen, anhängig davon, wer von deinem Okta-Konto auf Clockify zugreifen möchte

Das ist alles! Jetzt können Benutzer deines Arbeitsbereichs und du mit SAML2 in eurem Arbeitsbereich anmelden.

Schritt 1: Subdomain in Clockify erstellen #

Für weitere Informationen darüber kannst du den Abschnitt "Benutzerdefinierte Subdomain einrichten" lesen.

Schritt 2: Anwendung in OneLogin erstellen #

1. Zu "Anwendung" navigieren
2. Auf "App hinzufügen" klicken
3. Nach SAML Custom Connector(Erweitert) suchen und ihn auswählen
4. Info:
   • Anzeigename: Clockify
   • Logo: z. B. Clockify-Logo hochladen

Auf "Speichern" klicken und die Konfiguration ausfüllen:

• Audience: Clockify
• Recipient: https://global.api.clockify.me/auth/saml2
• ACS (Consumer) URL Validator*: ^https:\/\/global.api.clockify\.me\/auth\/saml2\/$
• ACS (Consumer) URL*: https://global.api.clockify.me/auth/saml2
• Anmelde-URL: https://yourcompanysubdomain.clockify.me/
• SAML-Initiator: Service Provider
• Klicke auf Speichern an, um den Vorgang abzuschließen

Schritt 3: SSO-Konfiguration in Clockify hinzufügen #

1. SSO-Konfiguration hinzufügen anklicken
2. SAML2 als Authentifizierungstyp wählen
3. Choose OneLogin as IdP Template and fill out the following fields
   • Audience (Entity Id): Clockify
   • Metadata Url: Go to OneLogin > SSO and copy Issuer URL then paste it in Metadata Url in Clockify
   • Login Url: Copy/paste SAML 2.0 Endpoint (HTTP) from SSO section in OneLogin

Im Erweitert eingeben:

• Zertifikat: X.509 Zertifikat aus “Details anzeigen”, SSO in OneLogin kopieren und einfügen

Schritt 4: Anwendung in OneLogin zuweisen #

In OneLogin:

1. Zu Benutzer navigieren (du solltest hier einen Benutzer von deinem OneLogin-Konto auswählen, der auf Clockify zugreifen kann)
2. Auf den bestimmten Benutzer klicken
3. Auf + in "Anwendungen" klicken, um eine App hinzufügen
4. Clockify wählen
5. Auf "Weiter" und "Speichern" klicken

Nach der Eingabe aller erforderlichen Daten kannst du dich entscheiden, deine Konfiguration zu testen, indem du auf die Schaltfläche Konfiguration testen klickst. Diese Aktion stellt die Genauigkeit der angegebenen Informationen sicher. Wenn alles korrekt ist, wird die Schaltfläche Konfiguration testen mit der Schaltfläche Konfiguration abschließen gewechselt.

In Clockify solltest du auf "Konfiguration abschließen" klicken, um den Vorgang abzuschließen und Anmeldung mit SAML 2.0 zu ermöglichen. Optional kannst du Anmeldung mit E-Mail und Passwort" deaktivieren.

Das ist alles! Jetzt können Benutzer deines Arbeitsbereichs und du mit SAML2 in eurem Arbeitsbereich anmelden.

Wenn du auf Subdomain umziehst, funktioniert die Google-Anmeldung nicht mehr und du sollst es manuell konfigurieren, um mit der Verwendung weiterzumachen.

Die Einrichtung von Google-Anmeldung ist schnell und einfach.

Du solltest ein G Suite- oder Cloud Identity -Konto haben, um das zu erledigen.

Du solltest OAuth 2.0 in deinem Google-Konto einrichten, ein Projekt erstellen und OAuth-Kunde-ID für eine Web-Anwendung erhalten.

In der Google-Cloud-Plattform solltest du zu "API und Dienste" navigieren und "Anmeldeinformationen" wählen. Öffne das Projekt/die Anwendung, das/die du erstellt hast und füge https://yoursubdomain.clockify.me/login in Autorisierte Umleitungs -URIs ein.

Außerdem solltest du die folgenden URIs hinzufügen, damit die OAuth-Anmeldung in mobilen Clockify-Apps funktioniert:

• https://app.clockify.me/login
• https://app.clockify.me/login/android/oauth2
• https://app.clockify.me/login/ios/oauth2

Regionale Weiterleitung #

Wenn du regionale Server für Hosting verwendest, stehen dir die folgenden URLs zur regionalen Weiterleitung zur Verfügung:

Vereinigte Staaten (US)

• Android: https://use2.clockify.me/en/login/android/oauth2 
• iOS: https://use2.clockify.me/en/login/ios/oauth2

Australien (AU)

• Android: https://apse2.clockify.me/en/login/android/oauth2
• iOS: https://apse2.clockify.me/en/login/ios/oauth2

Europa (EU)

• Android: https://euc1.clockify.me/en/login/android/oauth2
• iOS: https://euc1.clockify.me/en/login/ios/oauth2 

Vereinigtes Königreich (UK)

• Android: https://euw2.clockify.me/en/login/android/oauth2
• iOS: https://euw2.clockify.me/en/login/ios/oauth2

1. In Clockify zur Registerkarte Authentifizierung gehen
2. Auf SSO-Konfiguration hinzufügen klicken
3. OAuth2-Authentifizierungstyp wählen
4. Google im Fenster "IdP-Vorlagen" wählen
5. Auf "Weiter" klicken
6. Kunde-ID und den geheimen Kundenschlüssel aus deiner Google-App wie im Beispiel unten (Felder im Abschnitt "Erweitert" werden vorausgefüllt) kopieren/einfügen

Dein Bildschirm in Clockify sollte so aussehen:

und

Nach der Eingabe aller erforderlichen Daten kannst du dich entscheiden, deine Konfiguration zu testen, indem du auf die Schaltfläche Konfiguration testen klickst. Diese Aktion stellt die Genauigkeit der angegebenen Informationen sicher. Wenn alles korrekt ist, wird die Schaltfläche Konfiguration testen mit der Schaltfläche Konfiguration abschließen gewechselt.

Du solltest auf "Konfiguration abschließen" klicken, um den Vorgang zu vervollständigen. Um mit der Verwendung der Google-Anmeldung zu starten, solltest du das Kontrollkästchen "Mit OAuth einloggen" wählen. Optional kannst du alle Mitarbeiter daran hindern, die Google-Identität deiner Firma zum Einloggen zu benutzen, indem du "Anmeldung mit E-Mail und Passwort" deaktivierst.

Du kannst Azure mit Clockify verbinden, indem du OAuth einrichtest.

Schritt 1: Subdomain in Clockify erstellen #

Für weitere Informationen darüber kannst du den Abschnitt "Benutzerdefinierte Subdomain einrichten" lesen.

Schritt 2: SSO-Konfiguration in Clockify hinzufügen #

1. SSO-Konfiguration hinzufügen anklicken
2. OAuth2 als Authentifizierungstyp wählen
3. Im Fenster "IdP-Vorlage"Azure wählen
4. URL umleiten kopieren

Schritt 3: Anwendung in AzureAD registrieren #

1. Zur "App-Registrierung" navigieren
2. Auf "Neue Registration" klicken
3. Folgende Informationen eingeben:
   • Info:
     • Name: Clockify
     • Unterstützte Kontotypen: Wähle, was du bevorzugst; das ist in unserem Fall “Nur Konten in diesem Organisationsverzeichnis" (Nur Standardverzeichnis - Single Tenant) (Default Directory only – Single tenant)
     • Redirect URI: Füge die Redirect URL ein, die du im Schritt 2 kopiert hast; https://yourcompanysubdomain.clockify.me/login (es kann auch sein: https://app.clockify.me/login/ios/oauth2 oder https://app.clockify.me/login/android/oauth2) und klicke auf Registrieren, um weiter zu machen.

Oder, wenn du einen regionalen Server verwendest, solltest du eine der regionalen URLs hinzufügen.

Schritt 4: Konfigurieren (Clockify und Azure) #

AzureAD konfigurieren:  #

• Zertifikate und Geheimnisse::
  • Wähle Neuer geheimer Clientschlüssel
    • Beschreibung: Clockify
    • Ablaufdatum: nie
    • Klicke auf Hinzufügen
  • Clientschlüssel (Client Secret): Geheimniswert kopieren und einfügen
  • API-Berechtigungen:
    • Eine Berechtigung hinzufügen
      • Microsoft Graph
      • In "Delegierte Berechtigungen" permissions openid wählen
      • Berechtigungen hinzufügen (du kannst auch andere Berechtigungen markieren, wie E-Mail und Profil)
  • Seite aktualisieren
  • Zur "Übersicht" zurücknavigieren

  Clockify konfigurieren #

  • OAuth2 -Authentifizierung::
    • Kunde-ID: Zu Azure navigieren - Übersicht - Anwendung(Client)-ID: die Wert kopieren und in Clockify einfügen
    • Clientschlüssel (Client Secret): das sollte in vorigen Schritten schon eingefügt werden (Zertifikate und Geheimnisse)
    • Directory (tenant) ID: Zu Azure navigieren - Übersicht - Directory(Tenant)-ID-Wert kopieren und in Clockify einfügen

  Die Felder im Abschnitt Erweitert sind bereits ausgefüllt.

  Dein Bildschirm in Clockify sollte so aussehen:

  

  und

  

  Nach der Eingabe aller erforderlichen Daten kannst du dich entscheiden, deine Konfiguration zu testen, indem du auf die Schaltfläche Konfiguration testen klickst. Diese Aktion stellt die Genauigkeit der angegebenen Informationen sicher. Wenn alles korrekt ist, wird die Schaltfläche Konfiguration testen mit der Schaltfläche Konfiguration abschließen gewechselt.

  Klicke auf "Konfiguration abschließen" klicken, um den Prozess abzuschließen. Markiere das Kästchen "Mit OAuth anmelden" (und deaktiviere optional "Anmeldung mit E-Mail und Passwort").

  Alternativ kannst du Azure verbinden, indem du das SAML2-Authentifizierungsprotokoll benutzt und eine nicht gelistete Anwendung (Nicht-Kataloganwendung) zu deiner Azure AD-Organisation hinzufügst und dann die SAML-basierte einmalige Anmeldung für diese Nicht-Kataloganwendung konfigurierst.

  Weniger anzeigen

Schritt 1: Subdomain in Clockify erstellen #

Für weitere Informationen darüber kannst du den Abschnitt "Benutzerdefinierte Subdomain einrichten" lesen.

Schritt 2: Anwendung in Azure hinzufügen #

1. Zu "Enterprise-Anwendung" navigieren
2. Neue Anwendung (du solltest dann sicherstellen, dass du in der neuen Galerie-Ansicht bist)
3. "Deine eigene Anwendung" wählen
4. Die folgenden Informationen eingeben:
   • Name: Clockify
   • Jede andere Anwendung integrieren, die man in der Galerie nicht findet

Klicke auf Erstellen, an und navigiere zu "Eigenschaften" und fülle die Felder aus:

• Logo: z. B. Clockify-Logo hochladen
• "Benutzerzuweisung erforderlich" und "Für Benutzer sichtbar" ggf. optional ändern

Klicke auf Speichern klicken, um den Vorgang abzuschließen.

Schritt 3: Clockify #

1. SSO-Konfiguration hinzufügen anklicken
2. SAML2 als Authentifizierungstyp wählen
3. Auf "Weiter" klicken

Sobald du die Vorlage "SAML2 Authentifizierung" erhältst, solltest du zu Azure zurückgehen.

Schritt 4: Azure SSO-Konfiguration #

1. Zu "Einmalige Anmeldung" in der Seitenleiste
2. SAML wählen
3. Basic SAML Configuration (zur Bearbeitung auf den Schift klicken)
   • Identifier (Entity ID): Das ist, wo du deine Subdomain-Adresse eingibst, z. B. https://yourcompanysubdomain.clockify.me/
   • Reply URL (Assertion Consumer Service URL): zu Clockify zurücknavigieren und die bereits erstellte Reply URL kopieren, z. B. https://global.api.clockify.me/auth/saml2

Klicke Speichern an und mache mit SAML-Zertifikat weiter (zur Bearbeitung auf den Stift klicken):

• Neues Zertifikat

Du solltest Änderungen speichern und auf die 3 Punkte beim Inaktiv-Zertifikat klicken, "Zertifikat als aktiv festlegen" wählen und "Ja" anklicken.

Jetzt solltest du die Seite erneut laden, um die Änderungen zu sehen.

Schritt 5: Clockify #

1. Entity-ID: (das ist, wo du deine Subdomain-Adresse eingibst, falls sie https://yourcompanysubdomain.clockify.me/ ist)
2. Federation Metadata: zu Azure navigieren, unter "SAML-Zertifikat" "App Federation Metadata Url" kopieren und in Clockify einfügen.

Anmelde-Url: zu Azure navigieren, unter "Clockify einrichten" Anmelde-URL finden und kopieren und in Clockify einfügen.

Der Bildschirm sollte so aussehen:

und so:

Nach der Eingabe aller erforderlichen Daten kannst du dich entscheiden, deine Konfiguration zu testen, indem du auf die Schaltfläche Konfiguration testen klickst. Diese Aktion stellt die Genauigkeit der angegebenen Informationen sicher. Wenn alles korrekt ist, wird die Schaltfläche Konfiguration testen mit der Schaltfläche Konfiguration abschließen gewechselt.

Du solltest auf "Konfiguration abschließen" klicken, "Mit SAML2 anmelden" aktivieren (und "Anmeldung mit E-Mail und Passwort") deaktivieren).

Schritt 6: Anwendung in Azure zuweisen #

1. Zu "Benutzer und Gruppen" in der Randleiste navigieren (wo du Benutzer von deinem Azure-Konto wählst, die über den Zugriff auf Clockify verfügen)
2. Klicke auf "Benutzer/Gruppe hinzufügen" klicken
3. Im "Benutzer und Gruppen" Benutzer auswählen
4. Auf "Auswählen" und "Zuweisen" klicken

Schritt 1: Subdomain in Clockify erstellen #

Für weitere Informationen darüber kannst du den Abschnitt "Benutzerdefinierte Subdomain einrichten" lesen.

Schritt 2: Anwendung in Okta erstellen #

1. Zu Anwendungen in der Seitenleiste
2. Auf die Schaltfläche "App-Integration erstellen" klicken
3. "OIDC – OpenID Connect" im Abschnitt "Anmeldemethode" wählen
4. "Web-Anwendung" im Abschnitt "Anmeldungstyp" wählen
5. Auf "Weiter" klicken

OIDC-Integration erstellen #

In den Allgemeinen Einstellungen, "New Web App Integration" solltest du die folgenden Informationen eingeben und auf "Speichern" klicken.

1. App-Integration-Name: z. B. Clockify
2. Logo (optional): z. B. Clockify-Logo hochladen
3. Anmelde-Redirect-URIs: URL von "Redirect URL" ("Erweitert"-Abschnitt) kopieren und in Clockify-SSO-Konfiguration einfügen

Du solltest die folgenden URIs auch hinzufügen, damit die OAuth 2.0 (OIDC)-Anmeldung in mobilen Clockify-Apps funktioniert:

• https://app.clockify.me/login
• https://app.clockify.me/login/android/oauth2
• https://app.clockify.me/login/ios/oauth2

Oder, wenn du einen regionalen Server verwendest, solltest du eine der regionalen URLs hinzufügen.

Dann solltest du im Abschnitt "Aufträge" nach unten scrollen, die Option "Zugriff jedem Benutzer in deiner Organisation zulassen" markieren und auf "Speichern" klicken, um die Aktion abzuschließen.

Dein Bildschirm sollte so aussehen:

Schritt 3: SSO-Konfiguration in Clockify hinzufügen #

Jetzt solltest du im Clockify-Bildschirm Authentifizierung, in dem du deine Subdomain erstellt hast:

1. Auf SSO-Konfiguration hinzufügen unten im Bildschirm klicken
2. OAuth2 als Authentifizierungstyp wählen
3. Okta als IdP-Vorlage wählen
4. Auf "Weiter" klicken

Im OAuth 2.0 (OIDC)-Authentifizierung-Form solltest du die folgenden Informationen eingeben:

• Kunde-ID: sie wurde in Okta im vorigen Schritt generiert; du solltest sie aus dem Abschnitt "Anmeldeinformationen des Kunden" scrollen
• Clientschlüssel (Client Secret): gleich wie die Kunde-ID; du solltest ih aus "Anmeldeinformationen des Kunden" scrollen
• Okta-Domain: Die aus Okta, "Allgemeine Einstellungen", Okta -Domain-Feld kopieren (Hinweis: Für die Okta-Domain ist nur ein Domain-Name erforderlich, zum Beispiel: doamin_name.okta.com statt https://domain_name.okta.com)
• Der Abschnitt "Erweitert" ist bereits ausgefüllt (automatisch generiert)

Der Bildschirm sollte so aussehen:

und

Schritt 4: Anwendung in Okta zuweisen #

In Okta:

1. Zu "Anwendung" navigieren
2. Clockify wählen
3. In der Registerkarte "Aufträge" auf "Zuweisen" klicken
4. "Personen/Gruppen zuweisen" wählen, anhängig davon, wer von deinem Okta-Konto auf Clockify zugreifen möchte

Nach der Eingabe aller erforderlichen Daten kannst du dich entscheiden, deine Konfiguration zu testen, indem du auf die Schaltfläche Konfiguration testen klickst. Diese Aktion stellt die Genauigkeit der angegebenen Informationen sicher. Wenn alles korrekt ist, wird die Schaltfläche Konfiguration testen mit der Schaltfläche Konfiguration abschließen gewechselt.

In Clockify solltest du auf "Konfiguration abschließen" klicken, um den Vorgang zu vervollständigen und "Anmeldung mit OAuth" zu ermöglichen. Du kannst "Anmeldung mit E-Mail und Passwort" optional deaktivieren.

Dein Bildschirm in Clockify sollte etwa so aussehen:

Das ist alles! Jetzt können sich Benutzer deines Arbeitsbereichs und du bei deinem Arbeitsbereich mit OAuth 2.0 (OIDC) anmelden.