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.
- Überprüfen Sie, ob Sie angemeldet sind und über die Berechtigung zum Erstellen, Aktualisieren und Löschen von Inhalten verfügen.
- Klicken Sie auf der Registerkarte Eigene Inhalte der Inhaltsseite auf Neues Element, und klicken Sie auf Anwendung.
- 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.
- Für Web Mapping, Desktop oder Mobil geben Sie die URL der Anwendung ein, beispielsweise https://<myServer>/myWebMapApp.
- Für Desktop-Apps klicken Sie auf Durchsuchen und wählen die .zip-Datei aus, die die App enthält.
- Klicken Sie auf Weiter.
- Geben Sie einen Titel an.
- Wählen Sie den Ordner unter Eigene Inhalte aus, in dem Sie das Element speichern möchten.
Sie können auch die Menüoption Neuen Ordner erstellen auswählen und einen Ordnernamen eingeben, um das Element in einem neuen Ordner zu speichern.
Ordnernamen dürfen keine 4-Byte-Unicode-Zeichen enthalten.
- 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.
- Geben Sie optional Tags zur Beschreibung des Elements ein.
Trennen Sie die Begriffe durch Kommas (z. B. Bundesland wird als ein Tag und bundesstaatlich, 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.
- Fügen Sie optional eine aussagekräftige Zusammenfassung für die App ein.
- 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.
Alternativ können Sie beim Registrieren einen API-Schlüssel in die App einbetten.
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.
- Überprüfen Sie, ob Sie mit einem Organisationskonto angemeldet sind, dem Berechtigungen zum Erstellen, Aktualisieren und Löschen von Inhalten zugewiesen sind.
- Klicken Sie auf der Inhaltsseite auf der Registerkarte Eigene Inhalte auf Neues Element.
- Klicken Sie im Fenster Neues Element auf Entwickler-Anmeldeinformationen.
- Wählen Sie die Option OAuth 2.0-Anmeldeinformationen aus, und klicken Sie auf Weiter.
- 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
- 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.
- Wählen Sie unter Anwendungsumgebung eine Anwendungsumgebung für die App aus: Mehrere, Nativ, Browser oder Server.
- Geben Sie im Feld URL eine URL für die App im Format https://<myServer>/myWebMapApp ein.
- 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.
- 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.
Informationen zu Berechtigungstypen finden Sie in der Anleitung Security and authentication in der Esri Hilfe für Entwickler.
- 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.
- Geben Sie einen Titel an.
- Wählen Sie den Ordner unter Eigene Inhalte aus, in dem Sie das Element speichern möchten.
Sie können auch die Menüoption Neuen Ordner erstellen auswählen und einen Ordnernamen eingeben, um das Element in einem neuen Ordner zu speichern.
Ordnernamen dürfen keine 4-Byte-Unicode-Zeichen enthalten.
- 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.
- Geben Sie optional Tags zur Beschreibung des Elements ein.
Trennen Sie die Begriffe durch Kommas (z. B. Bundesland wird als ein Tag und bundesstaatlich, 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.
- Fügen Sie optional eine aussagekräftige Zusammenfassung für die App ein.
- Klicken Sie auf Weiter.
- Prüfen Sie die Zusammenfassung der Anmeldeinformationen. Klicken Sie auf Zurück, um Einstellungen zu ändern, bevor Sie ein Element erstellen.
- Wenn Sie persönliche Berechtigungen für die Anmeldeinformationen erteilt haben, aktivieren Sie das Kontrollkästchen neben der Bestätigung der Sicherheitsinformationen, um zu bestätigen, dass Sie diese gelesen haben und diesen zustimmen. Klicken Sie dann auf Erstellen, um die Anmeldeinformationen zu erstellen.
Die App wird Ihren Inhalten hinzugefügt, und die zugehörige Elementseite wird angezeigt. Eine Plakette 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. Auf der Registerkarte Übersicht der Elementseite wird mit der Kennzeichnung angegeben, ob in den Anmeldeinformationen persönliche Berechtigungen oder nur Standardberechtigungen enthalten sind.
Sie können die Elementdetails konfigurieren, die Sie für die App verwenden möchten.
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.
Hinweis:
Der Abschnitt Verwendung anzeigen ist nicht verfügbar, wenn Sie sich über eine ArcGIS Location Platform-Subskription angemeldet haben.
Für die in die App eingebetteten Anmeldeinformationen können Sie auch Einstellungen verwalten.
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.
- Überprüfen Sie, ob Sie mit einem Organisationskonto angemeldet sind, dem Berechtigungen zum Erstellen von API-Schlüsseln sowie zum Erstellen, Aktualisieren und Löschen von Inhalten zugewiesen sind.
- Klicken Sie auf der Inhaltsseite auf der Registerkarte Eigene Inhalte auf Neues Element.
- Klicken Sie im Fenster Neues Element auf Entwickler-Anmeldeinformationen.
- Wählen Sie die Option Anmeldeinformationen für API-Schlüssel aus, und klicken Sie auf Weiter.
- 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.
- 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 URLs müssen mit einer der registrierten URLs übereinstimmen, andernfalls wird die Autorisierung abgelehnt.
Die folgenden Formate von Referrer-URLs werden beispielsweise unterstützt:
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- Klicken Sie auf Weiter.
- 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.
Informationen zu Berechtigungstypen finden Sie in der Anleitung Security and authentication in der Esri Hilfe für Entwickler.
- 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.
- Geben Sie einen Titel an.
- Wählen Sie den Ordner unter Eigene Inhalte aus, in dem Sie das Element speichern möchten.
Sie können auch die Menüoption Neuen Ordner erstellen auswählen und einen Ordnernamen eingeben, um das Element in einem neuen Ordner zu speichern.
Ordnernamen dürfen keine 4-Byte-Unicode-Zeichen enthalten.
- 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.
- Geben Sie optional Tags zur Beschreibung des Elements ein.
Trennen Sie die Begriffe durch Kommas (z. B. Bundesland wird als ein Tag und bundesstaatlich, 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.
- Fügen Sie optional eine aussagekräftige Zusammenfassung für die App ein.
- Klicken Sie auf Weiter.
- Prüfen Sie die Zusammenfassung der Anmeldeinformationen. Klicken Sie auf Zurück, um Einstellungen zu ändern, bevor Sie ein Element erstellen.
- Wenn Sie persönliche Berechtigungen für die Anmeldeinformationen erteilt haben, aktivieren Sie das Kontrollkästchen neben der Bestätigung der Sicherheitsinformationen, um zu bestätigen, dass Sie diese gelesen haben und diesen zustimmen. Klicken Sie dann auf Weiter.
- Legen Sie fest, ob der API-Schlüssel sofort oder später generiert werden soll, und klicken Sie auf Weiter.
Kopieren Sie den API-Schlüssel, sobald er generiert wurde.
- Wenn Sie auf die Option API-Schlüssel erstellen und zur Elementdetailseite wechseln. Ich bin bereit, den Schlüssel zu kopieren und zu speichern. und dann auf Weiter klicken, wird das Pop-up API-Schlüssel generieren angezeigt. Klicken Sie auf die Schaltfläche Kopieren, um den Schlüssel zu kopieren. Fügen Sie den Schlüssel in ein sicheres Dokument ein. Schließen Sie das Pop-up, wenn Sie fertig sind.
- Wenn Sie auf die Option Zur Elementdetailseite wechseln. Ich generiere den API-Schlüssel zu einem späteren Zeitpunkt. klicken, wird die Elementdetailseite der Anmeldeinformationen angezeigt. Die Elementseite wird angezeigt, wenn Sie auf Weiter klicken. Sie können den API-Schlüssel auf der Registerkarte Einstellungen der Elementseite generieren.
Die App wird Ihren Inhalten hinzugefügt, und die zugehörige Elementseite wird angezeigt. Eine Plakette 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. Auf der Registerkarte Übersicht der Elementseite wird mit der Kennzeichnung angegeben, ob in den Anmeldeinformationen persönliche Berechtigungen oder nur Standardberechtigungen enthalten sind.
Sie können die Elementdetails konfigurieren, die Sie für die App verwenden möchten.
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.
Hinweis:
Der Abschnitt Verwendung anzeigen ist nicht verfügbar, wenn Sie sich über eine ArcGIS Location Platform-Subskription angemeldet haben.
Für die in die App eingebetteten Anmeldeinformationen können Sie auch Einstellungen verwalten.