Eine App im Marktplatz veröffentlichen
Als Entwickler registrieren Sie eine Drittanbieter-App, definieren die von ihr angeforderten Scopes, erstellen die OAuth-Zugangsdaten (client_id und client_secret) und reichen die App zur Prüfung ein. Sobald das Team sie genehmigt und veröffentlicht, kann jeder Tenant Ihre App installieren.
Das Entwicklerportal befindet sich unter Apps, auf dem Tab Entwickler. Dort registrieren Sie eine App, definieren, worauf sie zugreifen kann, generieren die OAuth-Zugangsdaten und reichen sie zur Veröffentlichung ein. Nur Administratoren können Apps verwalten.
App registrieren und konfigurieren
- Öffnen Sie Apps und gehen Sie zum Tab Entwickler. Klicken Sie auf Neue App.
- Füllen Sie Name, Kennung (Slug), Kurz- und Vollbeschreibung aus. Das Symbol und die Website-URLs müssen, sofern angegeben, https sein.
- Überprüfen Sie die angeforderten Scopes: Fordern Sie nur das notwendige Minimum an. Der Tenant gewährt bei der Installation eine Teilmenge.
- Wenn die App Widgets einbettet, listen Sie die erlaubten Ursprünge auf (einer pro Zeile, immer https). Fügen Sie Webhooks hinzu, wenn die App Ereignisse empfängt.
- Speichern Sie den Entwurf. Sie können bearbeiten, solange die App ein Entwurf ist oder abgelehnt wurde.
OAuth-Zugangsdaten
Erstellen Sie unter OAuth-Zugangsdaten einen Client für die App. Wählen Sie die Client-Scopes (immer eine Teilmenge der App-Scopes) und geben Sie die Redirect-URIs ein, die bei der Zustimmung durch exakte Übereinstimmung geprüft werden. Bei der Erstellung erscheinen client_id und client_secret nur einmal.
Zur Prüfung einreichen und veröffentlichen
- Klicken Sie mit der fertigen App auf Zur Prüfung einreichen. Der Status ändert sich zu In Prüfung.
- Das Team prüft und genehmigt oder lehnt mit einer Anmerkung ab. Bei Ablehnung passen Sie die App an und reichen erneut ein.
- Sobald sie genehmigt und veröffentlicht ist, erscheint die App im Katalog und jeder Tenant kann sie installieren.
Für die Details des OAuth-Ablaufs (Autorisieren, Token, Refresh und PKCE) siehe die Entwicklerdokumentation. Der Zugriff der App ist immer auf das beschränkt, dem der Benutzer bei der Installation zustimmt.