Hinzufügen und Registrieren einer App

Das Hinzufügen einer URL-Referenz zu einer vorhandenen App ist eine effektive Möglichkeit, Ihre Arbeit für Mitglieder Ihrer Organisation und die Öffentlichkeit freizugeben (je nach Freigabeberechtigungen). Neben der URL können Sie auch andere Details wie den Typ der App, deren Zweck, eine Zusammenfassung und eine Beschreibung sowie eine .zip-Datei mit dem Code hinzufügen, den Sie zum Erstellen der App verwendet haben. Wenn in ArcGIS Online eine App hinzugefügt wird, wird nur ein Verweis zur App-URL hinzugefügt. ArcGIS Online speichert keine App-Dateien.

Als Entwickler mit einem Organisationskonto können Sie außerdem Apps bei der Plattform registrieren. Dabei wird eine OAuth-Anwendung registriert, sodass Organisationsmitglieder und Benutzer außerhalb der Organisation sich bei der App anmelden können. Weitere Informationen finden Sie weiter unten im Abschnitt Hinzufügen und Registrieren einer App mit Entwickleranmeldeinformationen.

Wenn Sie die App nicht registrieren müssen, beispielsweise beim Hochladen eines Codebeispiels, führen Sie die Schritte im Abschnitt Hinzufügen einer App über eine URL weiter unten aus.

Tipp:

Eine andere Möglichkeit der Freigabe von Anwendungen für Mitglieder Ihrer Organisation und die Öffentlichkeit besteht darin, Anwendungen mit Karten und Galerieanwendungen mit Gruppen zu erstellen.

Hinzufügen einer App über eine URL

Führen Sie diese Schritte aus, um ein Element hinzuzufügen, das eine URL für den Zugriff auf eine Web-App verwendet, aber nicht registriert werden muss (z. B. Codebeispiele):

Hinweis:

Zum Hinzufügen einer registrierten App führen Sie die Schritte zum Hinzufügen und Registrieren einer App mit Entwickleranmeldeinformationen aus.

  1. Überprüfen Sie, ob Sie angemeldet sind und über die Berechtigung zum Erstellen von Inhalten verfügen.
  2. Klicken Sie auf der Registerkarte Eigene Inhalte der Inhaltsseite auf Neues Element, und klicken Sie auf Anwendung.
  3. Wählen Sie den App-Typ aus:
    • Web Mapping: Eine Web-App, die mit einer Web-API wie JavaScript erstellt wurde.
    • Desktop: Eine App für Desktops, die auf einer Desktop-Plattform wie Java oder .NET (Microsoft Windows Desktop) entwickelt wurde.
    • Mobil: Eine herunterladbare App, mit einem SDK für Mobilgeräte erstellt, z. B. für iOS oder Android.
    • Sonstige Anwendung: Eine Desktop-Anwendung, ein Python-Skript oder ein beliebiger Typ von generischer App ohne Details zum Zweck, zur API, zum SDK oder zur URL-Adresse.
  4. Für Web Mapping, Desktop oder Mobil geben Sie die URL der Anwendung ein, beispielsweise https://<myServer>/myWebMapApp.
  5. Für Desktop-Apps klicken Sie auf Durchsuchen und wählen die .zip-Datei aus, die die App enthält.
  6. Klicken Sie auf Weiter.
  7. Geben Sie einen Titel ein.
  8. Wählen Sie den Ordner unter Eigene Inhalte aus, in dem Sie das Element speichern möchten.
  9. Wenn in Ihrer Organisation Inhaltskategorien eingerichtet wurden, klicken Sie auf Kategorien zuweisen, und wählen Sie bis zu 20 Kategorien aus, damit andere das Element finden können.

    Sie können auch mit der Eingabe eines Kategorienamens beginnen, um die Liste der Kategorien einzugrenzen.

  10. Geben Sie optional Tags zur Beschreibung des Elements ein.

    Trennen Sie Begriffe durch Kommas (z. B. Bund Land wird als ein Tag; Bund, Land hingegen als zwei Tags betrachtet).

    Während der Eingabe können Sie alle vorgeschlagenen Tags auswählen, die angezeigt werden. Vorschläge werden aus Tags erstellt, die Sie zuvor hinzugefügt haben.

  11. Fügen Sie optional eine aussagekräftige Zusammenfassung für die App ein.
  12. Klicken Sie auf Speichern.

Nach dem Hinzufügen der App wird sie unter "Eigene Inhalte" angezeigt. Wenn Sie die App zu einem späteren Zeitpunkt registrieren müssen, können Sie dazu die Registerkarte Einstellungen der Elementseite der App verwenden. Weitere Informationen finden Sie weiter unten im Abschnitt Hinzufügen und Registrieren einer App mit Entwickleranmeldeinformationen.

Sie können die Elementdetails konfigurieren, bei Bedarf Code hinzufügen und die App freigeben, wenn Sie über Berechtigungen zum Freigeben verfügen.

Hinzufügen und Registrieren einer App mit Entwickleranmeldeinformationen

Als Entwickler mit einem Organisationskonto können Sie Ihre App hinzufügen und bei der Plattform registrieren, um eine App-ID zu generieren. Verwenden Sie die App-ID in der App, um Nutzungsstatistiken zu erfassen und Benutzern die Anmeldung mit OAuth 2.0, einer standardisierten Autorisierungsumgebung, zu erlauben. Mit OAuth 2.0 führen Apps den Benutzer über eine von einer Plattform gehostete Anmeldeseite durch den Anmeldevorgang bei der Plattform. Ferner können Benutzer die App verwenden, um mit Benutzerinhalten, die mit ihrer Organisation verknüpft sind, zu arbeiten, oder andere ArcGIS Online-Funktionen, wie Geokodierung, Routing und GeoEnrichment, zu nutzen. Weitere Informationen zur Authentifizierung und zu OAuth 2.0 finden Sie unter Esri Developer.

Welche Entwickler-Anmeldeinformationen Sie in die App einbinden können, hängt von den Berechtigungen Ihrer Organisation ab. Wenn Sie ein Mitglied der Standardadministratorrolle oder einer benutzerdefinierten Rolle sind und über die Berechtigung zum Generieren von API-Schlüsseln verfügen, können Sie in Ihrer App OAuth 2.0-Anmeldeinformationen verwenden oder solche, die auf einem API-Schlüssel basieren. Andernfalls können Sie nur OAuth 2.0-Entwickler-Anmeldeinformationen in einer App verwenden.

Hinweis:

Das Implementierungsmuster für Benutzeranmeldungen hängt davon ab, ob Sie eine webbasierte oder eine native App entwickeln. Die Esri Developer-Dokumentation beinhaltet detaillierte Erläuterungen und Code-Beispiele für webbasierte und native Apps.

Hinzufügen und Registrieren einer App mit eingebetteten OAuth 2.0-Anmeldeinformationen

Wenn Sie OAuth 2.0-Anmeldeinformationen in den Apps verwenden, die Sie erstellen, wird das Zugriffstoken beim Zugriff auf die App dynamisch generiert. Das Zugriffstoken ist maximal 14 Tage gültig.

Führen Sie die folgenden Schritte aus, wenn Ihre Rolle nicht über die Berechtigung zum Erstellen von API-Schlüsseln verfügt.

  1. Überprüfen Sie, ob Sie mit einem Organisationskonto angemeldet sind, dem die Berechtigung zum Erstellen von Inhalten zugewiesen ist.
  2. Klicken Sie auf der Inhaltsseite auf der Registerkarte Eigene Inhalte auf Neues Element.
  3. Klicken Sie im Fenster Neues Element auf Entwickler-Anmeldeinformationen.
  4. Die Darstellung des ersten Fensters, das Ihnen angezeigt wird, hängt von Ihren Berechtigungen in der Organisation ab. Wenn Sie Mitglied einer Rolle sind, die nicht über die Berechtigung zum Erstellen von API-Schlüsseln verfügt, fahren Sie mit Schritt 5 fort. Wenn Ihre Rolle die Berechtigung zum Erstellen von API-Schlüsseln umfasst, fahren Sie mit Schritt 4 fort.
  5. Wählen Sie die Option OAuth 2.0-Anmeldeinformationen aus, und klicken Sie auf Weiter.
  6. Geben Sie unter Umleitungs-URLs die URL einer Webseite oder eines Server-Endpunkts an, die zum Umleiten von Benutzern nach der erfolgreichen Anmeldung verwendet werden soll. Klicken Sie auf Hinzufügen, um nach Bedarf weitere Umleitungs-URLs hinzuzufügen.

    Die bei der Autorisierung angegebenen Umleitungs-URLs müssen mit einer der registrierten URLs übereinstimmen, andernfalls wird die Autorisierung abgelehnt.

    Für Autorisierungsgenehmigungen kann auch der Sonderwert "urn:ietf:wg:oauth:2.0:oob" angegeben werden. In diesem Fall wird der Autorisierungscode in einer Portal-URL (/oauth2/approval) bereitgestellt. Dieser Wert wird in der Regel von Apps verwendet, die nicht über einen Webserver oder ein benutzerdefiniertes URL-Schema verfügen, in dem der Code bereitgestellt werden kann.

    Die folgenden Formate von Umleitungs-URLs werden beispielsweise unterstützt:

    • https://app.foo.com
    • urn:ietf:wg:oauth:2.0:oob

  7. Geben Sie unter Referrer-URLs eine URL oder IP-Adresse an, die für eine Verbindung zugelassen ist. Klicken Sie auf Hinzufügen, um nach Bedarf weitere Referrer-URLs oder IP-Adressen hinzuzufügen.
  8. Wählen Sie unter Anwendungsumgebung eine Anwendungsumgebung für die App aus: Mehrere, Nativ, Browser oder Server.
  9. Geben Sie im Feld URL eine URL für die App im Format https://<myServer>/myWebMapApp ein.
  10. Klicken Sie auf Weiter.

    Wenn Sie Mitglied einer Rolle sind, die die Berechtigung hat, OAuth 2.0-Anwendungen Berechtigungen zuzuweisen, gelangen Sie durch Klicken auf Weiter zu einem Fenster, in dem Sie definieren können, welche Aktionen die App ausführen darf. Wenn Sie nicht über diese Berechtigung verfügen, fahren Sie mit Schritt 12 fort.

  11. Legen Sie fest, welche Aktionen die App mit den Anmeldeinformationen durchführen darf, indem Sie Berechtigungen zuweisen, und klicken Sie anschließend auf Weiter.

    Die Liste der Berechtigungen, die Ihnen zur Verfügung stehen, hängt davon ab, ob Sie über eine ArcGIS Location Platform-Subskription verfügen und wird außerdem durch die Berechtigungen bestimmt, über die Sie innerhalb der Organisation verfügen. Sie können nur die Berechtigungen gewähren, die Ihrem Konto zugewiesen sind.

  12. Klicken Sie auf Elemente durchsuchen, und wählen Sie aus, auf welche Elemente mit den eingebetteten Anmeldeinformationen zugegriffen werden kann, und klicken Sie auf Elemente hinzufügen.

    Alternativ können Sie auf Überspringen klicken. Wenn Sie nicht angeben, auf welche Elemente die Benutzer der OAuth 2.0-Anmeldeinformationen Zugriff haben, können die Anmeldeinformationen für den Zugriff auf alle Elemente verwendet werden, die Sie besitzen.

  13. Geben Sie einen Titel ein.
  14. Wählen Sie den Ordner unter Eigene Inhalte aus, in dem Sie das Element speichern möchten.
  15. Wenn in Ihrer Organisation Inhaltskategorien eingerichtet wurden, klicken Sie auf Kategorien zuweisen, und wählen Sie bis zu 20 Kategorien aus, damit andere das Element finden können.

    Sie können auch mit der Eingabe eines Kategorienamens beginnen, um die Liste der Kategorien einzugrenzen.

  16. Geben Sie optional Tags zur Beschreibung des Elements ein.

    Trennen Sie Begriffe durch Kommas (z. B. Bund Land wird als ein Tag; Bund, Land hingegen als zwei Tags betrachtet).

    Während der Eingabe können Sie alle vorgeschlagenen Tags auswählen, die angezeigt werden. Vorschläge werden aus Tags erstellt, die Sie zuvor hinzugefügt haben.

  17. Fügen Sie optional eine aussagekräftige Zusammenfassung für die App ein.
  18. Klicken Sie auf Weiter.
  19. Prüfen Sie die Zusammenfassung der Anmeldeinformationen. Klicken Sie auf Zurück, um Einstellungen zu ändern, bevor Sie ein Element erstellen. Klicken Sie auf Erstellen, wenn die Einstellungen für die Anmeldeinformtionen korrekt sind.

Die App wird Ihren Inhalten hinzugefügt, und die zugehörige Elementseite wird angezeigt. Eine Plakette OAuth 2.0-Anmeldeinformationen wird auf der Elementseite und bei Anzeige des Elements auf der Inhaltsseite oder in der Elementvorschau angezeigt. Diese Plakette gibt an, dass OAuth 2.0-Anmeldeinformationen in der App verwendet werden.

Sie können die Elementdetails konfigurieren, die Sie für die App verwenden möchten.

Auf der Registerkarte Einstellungen der Elementseite der App können Sie Registrierungsinformationen anzeigen, die die App-ID (Client-ID), einen geheimem Schlüssel der App (Geheimer Clientschlüssel) und die Anwendungsumgebungen umfassen. Sie können die URL der Datenquelle oder die Umleitungs-URLs aktualisieren, den geheimen Schlüssel zurücksetzen, die Registrierung der Anwendung aufheben oder das temporäre App-Token kopieren oder erneuern. Sie können auch die Berechtigungen der App ändern und festlegen, auf welche Layer die App zugreifen kann.

Hinweis:

Wenn der geheime Zugriffsschlüssel der App zurückgesetzt wird, werden alle vorhandenen Benutzer und App-Token ungültig, die für die App ausgestellt wurden. Benutzer müssen sich erneut bei der App anmelden, und Apps, die mit dem geheimen Zugriffsschlüssel konfiguriert wurden, müssen eventuell aktualisiert werden.

Klicken Sie auf der Registerkarte Einstellungen auf Verwendung anzeigen, um Informationen darüber abzurufen, wer sich bei der App angemeldet hat und wie viele Credits verbraucht wurden.

Hinzufügen und Registrieren einer App mit eingebetteten API-Schlüssel-Anmeldeinformationen

Verwenden Sie API-Schlüssel-Anmeldeinformationen, wenn Sie die Anmeldeinformationen in die App einbetten möchten und der Schlüssel länger als 14 Tage gültig sein muss.

Führen Sie die Schritte unten aus, um eine App hinzuzufügen und einen eingebetteten API-Schlüssel für die Authentifizierung zu erstellen.

  1. Überprüfen Sie, ob Sie mit einem Organisationskonto angemeldet sind und Ihnen Berechtigungen zum Erstellen von Inhalten sowie API-Schlüsseln zugewiesen sind.
  2. Klicken Sie auf der Inhaltsseite auf der Registerkarte Eigene Inhalte auf Neues Element.
  3. Klicken Sie im Fenster Neues Element auf Entwickler-Anmeldeinformationen.
  4. Wählen Sie die Option Anmeldeinformationen für API-Schlüssel aus, und klicken Sie auf Weiter.
  5. Verwenden Sie den Kalender, um ein Ablaufdatum für die Anmeldeinformationen festzulegen.

    Die Anmeldeinformationen können am nächsten Tag (Minimum) oder nach 365 Tagen (Maximum) ablaufen. Sie laufen um 23:59 Uhr an dem von Ihnen gewählten Datum ab. Die Uhrzeit wird auf der Grundlage der Uhrzeit gespeichert, die in Ihrem Browser angegeben wird, wenn Sie die App hinzufügen und die Anmeldeinformationen erstellen.

  6. Geben Sie unter Referrer-URLs eine URL oder IP-Adresse an, die für eine Verbindung mit der App zugelassen ist. Klicken Sie auf Hinzufügen, wenn weitere Referrer-URLs oder IP-Adressen benötigt werden.

    Die bei der Autorisierung angegebenen Umleitungs-URLs müssen mit einer der registrierten URLs übereinstimmen, andernfalls wird die Autorisierung abgelehnt.

  7. Klicken Sie auf Weiter.
  8. Legen Sie fest, welche Aktionen die App mit den Anmeldeinformationen durchführen darf, indem Sie Berechtigungen zuweisen, und klicken Sie anschließend auf Weiter.

    Die Liste der Berechtigungen, die Ihnen zur Verfügung stehen, hängt davon ab, ob Sie über eine ArcGIS Location Platform-Subskription verfügen und wird außerdem durch die Berechtigungen bestimmt, über die Sie innerhalb der Organisation verfügen. Sie können nur die Berechtigungen gewähren, die Ihrem Konto zugewiesen sind.

  9. Klicken Sie auf Elemente durchsuchen, wählen Sie aus, auf welche Elemente mit den eingebetteten Anmeldeinformationen zugegriffen werden kann, und klicken Sie auf Elemente hinzufügen.

    Alternativ können Sie auf Überspringen klicken. Wenn Sie nicht angeben, auf welche Elemente die Benutzer der API-Schlüssel-Anmeldeinformationen Zugriff haben, können die Anmeldeinformationen für den Zugriff auf alle Elemente verwendet werden, die Sie besitzen.

  10. Geben Sie einen Titel ein.
  11. Wählen Sie den Ordner unter Eigene Inhalte aus, in dem Sie das Element speichern möchten.
  12. Wenn in Ihrer Organisation Inhaltskategorien eingerichtet wurden, klicken Sie auf Kategorien zuweisen, und wählen Sie bis zu 20 Kategorien aus, damit andere das Element finden können.

    Sie können auch mit der Eingabe eines Kategorienamens beginnen, um die Liste der Kategorien einzugrenzen.

  13. Geben Sie optional Tags zur Beschreibung des Elements ein.

    Trennen Sie Begriffe durch Kommas (z. B. Bund Land wird als ein Tag; Bund, Land hingegen als zwei Tags betrachtet).

    Während der Eingabe können Sie alle vorgeschlagenen Tags auswählen, die angezeigt werden. Vorschläge werden aus Tags erstellt, die Sie zuvor hinzugefügt haben.

  14. Fügen Sie optional eine aussagekräftige Zusammenfassung für die App ein.
  15. Klicken Sie auf Weiter.
  16. Prüfen Sie die Zusammenfassung der Anmeldeinformationen. Klicken Sie auf Zurück, um Einstellungen zu ändern, bevor Sie ein Element erstellen. Klicken Sie auf Erstellen, wenn die Einstellungen für die Anmeldeinformtionen korrekt sind.

Die App wird Ihren Inhalten hinzugefügt, und die zugehörige Elementseite wird angezeigt. Eine Plakette API-Schlüssel-Anmeldeinformationen wird auf der Elementseite und bei Anzeige des Elements auf der Inhaltsseite oder in der Elementvorschau angezeigt. Diese Plakette gibt an, dass API-Schlüssel-Anmeldeinformationen in der App verwendet werden.

Sie können die Elementdetails konfigurieren, die Sie für die App verwenden möchten.

Auf der Registerkarte Einstellungen der Elementseite der App können Sie Registrierungsinformationen anzeigen, die die App-ID (Client-ID), einen geheimem Schlüssel der App (Geheimer Clientschlüssel) und die Anwendungsumgebungen umfassen. Sie können die Umleitungs-URLs aktualisieren, den geheimen Schlüssel zurücksetzen, die Registrierung der Anwendung aufheben oder das temporäre App-Token kopieren oder erneuern. Sie können auch die Berechtigungen der App ändern und festlegen, auf welche Layer die App zugreifen kann.

Hinweis:

Wenn der geheime Clientschlüssel der App zurückgesetzt wird, werden alle vorhandenen Benutzer und App-Token ungültig, die für die App ausgestellt wurden. Benutzer müssen sich erneut bei der App anmelden, und Apps, die mit dem geheimen Zugriffsschlüssel konfiguriert wurden, müssen eventuell aktualisiert werden.

Klicken Sie auf der Registerkarte Einstellungen auf Verwendung anzeigen, um Informationen darüber abzurufen, wer sich bei der App angemeldet hat und wie viele Credits verbraucht wurden.

Verwandte Themen