Teile Links zu öffentlichen ClickUp-Ansichten sicher über OpenID Connect (OIDC).

Was du benötigst

• Ein Workspace-Eigentümer oder Administrator muss OpenID Connect für deinen Workspace konfigurieren.
• Ein Okta-Administratorkonto.
• Die Authentifizierung öffentlicher Ansichten ist nur in Enterprise-Plänen verfügbar.

Deine Callback-URL kopieren

Während der Konfiguration im Okta-App-Integrations-Assistenten musst du deine Callback-URL einfügen. So kopierst du deine Callback-URL aus ClickUp:

1. Aktiviere die Authentifizierung öffentlicher Ansichten in ClickUp.
2. Klicke rechts neben dem Feld „Callback-URL" auf Kopieren.

3. Deine Callback-URL hat je nach ClickUp-Konfiguration folgendes Format: https://app.clickup.com/data/v3/workspaces/{workspaceId}/oidc/callback.

Eine neue Anwendung in Okta registrieren

So registrierst du eine neue Anwendung in Okta:

1. Melde dich beim Okta-Admin-Dashboard deiner Organisation an.
2. Wähle die Registerkarte Anwendungen aus.
3. Wähle Anwendungen aus.

4. Klicke auf App-Integration erstellen.
5. Wähle als Anmeldemethode OIDC - OpenID Connect aus.
6. Wähle als Anwendungstyp Webanwendung aus.
7. Klicke auf Weiter.

Anwendungseinstellungen konfigurieren

So konfigurierst du die Anwendungseinstellungen in Okta:

1. Konfiguriere im Abschnitt Allgemeine Einstellungen des App-Integrations-Assistenten diese Felder:
   • Name der App-Integration: Gib einen aussagekräftigen Namen ein. Zum Beispiel: ClickUp OIDC integration.
   • App-Logo: Optional. Lade ein Logo hoch.
2. Konfiguriere im Abschnitt Abmeldung diese Felder:
   • Anmelde-Weiterleitungs-URIs: Füge den Wert aus dem Callback-URL-Feld in ClickUp ein. Hierhin sendet Okta OAuth-Antworten.
   • Abmelde-Weiterleitungs-URIs: Optional. Gib die Weiterleitungs-URL ein, falls deine Anwendung sie benötigt. Hierhin leitet Okta den Browser nach der Abmeldung bei der vertrauenden Partei und dem Beenden der Sitzung um.
3. Im Abschnitt Zuweisungen legst du mit diesen Optionen unter Gesteuerter Zugriff fest, wer auf diese Anwendung zugreifen darf:
   • Allen Personen in deiner Organisation den Zugriff erlauben: Die Standardoption.
   • Zugriff auf ausgewählte Gruppen beschränken: Gib die Namen der Gruppen ein, die auf die App zugreifen dürfen.
   • Gruppenzuweisung vorerst überspringen: Erstelle die App, ohne Gruppen zuzuweisen.
4. Klicke auf Speichern.

OIDC-Einstellungen konfigurieren

So konfigurierst du die OIDC-Einstellungen in Okta:

1. Öffne auf der Seite „Anwendungsdetails" die Registerkarte Allgemein im Abschnitt Client-Anmeldedaten.
2. Kopiere die Discovery-Dokument-URL. Die Discovery-URL für Okta hat folgendes Format: https://your-org.okta.com/.well-known/openid-configuration. Ersetze your-org durch die Subdomain deiner Okta-Organisation. Die Discovery-URL befüllt diese Felder in ClickUp:
   • Aussteller: issuer
   • Autorisierungsendpunkt: authorization_endpoint
   • Token-Endpunkt: token_endpoint
   • UserInfo-Endpunkt: userinfo_endpoint
   • JWKS-URI: jwks_uri
3. Kopiere den Wert der Client-ID. Zum Beispiel: 0oa2xyz123abc456def
4. Kopiere den Wert des Client-Secrets.

Bewahre das Client-Secret sicher auf. Es wird nicht erneut im Klartext angezeigt.

Zusätzliche Einstellungen konfigurieren

Diese Einstellungen sind optional:

• Token-Lebensdauer-Einstellungen: Scrolle auf der Registerkarte Allgemein nach unten zu Allgemeine Einstellungen. Passe bei Bedarf die Lebensdauer von Aktualisierungs-Token und Zugriffs-Token an.
• Zulässige Grant-Typen: Wenn du dieses Feld konfigurierst, stelle sicher, dass Autorisierungscode aktiviert ist – er wird für den OIDC-Workflow benötigt.

Deine Konfiguration testen

Diese Konfigurationen werden von deinem ClickUp-OIDC-Dienst automatisch verarbeitet, um alle weiteren erforderlichen Endpunkte und Einstellungen abzuleiten.

So testest du deine Konfiguration:

1. Rufe die Discovery-URL in einem Browser auf, um zu prüfen, ob sie eine gültige JSON-Konfiguration zurückgibt.
2. Teste den OIDC-Ablauf mit deiner Anwendung.
3. Überprüfe, ob die Callback-URL erreichbar und korrekt konfiguriert ist.