L’ajout d’une référence à une URL dans une application existante vous permet de partager efficacement votre travail avec les membres de votre organisation, ainsi qu’avec le public (selon vos privilèges de partage). En plus de l’URL, vous pouvez partager d’autres informations, telles que le type de l’application, son objectif, un résumé et une description, ainsi qu’un fichier .zip contenant le code que vous avez utilisé pour créer l’application. L’ajout d’une application à ArcGIS Online n’ajoute qu’une référence à l’URL de l’application ; ArcGIS Online ne stocke pas les fichiers de l’application.
En tant que développeur d’applications détenteur d’un compte d’organisation, vous pouvez également inscrire les applications auprès de la plateforme. Il s’agit d’inscrire une application OAuth de sorte que les membres de l’organisation et les utilisateurs en dehors de l’organisation puissent se connecter à l’application. Reportez-vous à la section Ajouter et inscrire une application avec des informations d’identification Developer ci-dessous pour plus d’informations.
S’il n’est pas nécessaire d’inscrire l’application, par exemple lors du chargement d’un exemple de code, suivez les étapes présentées dans la section Ajouter une application à partir d’une URL ci-dessous.
Conseil :
Pour partager des applications avec les membres de votre organisation, ainsi qu’avec le public, vous pouvez également créer des applications avec des cartes et des applications de bibliothèque avec des groupes.
Ajouter une application à partir d’une URL
Procédez comme suit pour ajouter un élément qui utilise une URL pour accéder à une application sur le Web, mais qu’il n’est pas nécessaire d’inscrire (par exemple, un exemple de code) :
Remarque :
Pour ajouter une application inscrite, procédez comme suit pour ajouter et inscrire une application avec des données d’identification Developer.
- Vérifiez que vous êtes connecté et que vous détenez le privilège nécessaire pour créer, mettre à jour et supprimer du contenu.
- Depuis l’onglet My content (Mon contenu) de la page de contenu, cliquez sur New item (Nouvel élément), puis sur Application (Application).
- Sélectionnez le type d’application :
- Web mapping (Cartographie Web) : application Web créée avec une API Web telle que JavaScript.
- Desktop (Bureau) : une application pour les ordinateurs de bureau intégrés à une plateforme bureautique, telle que Java ou .NET (Microsoft Windows Desktop).
- Mobile : application téléchargeable créée pour les appareils mobiles avec un SDK , comme iOS ou Android.
- Other application (Autre application) : application bureautique, script Python ou n’importe quel type d’application générique dont vous ne connaissez pas l’objectif, l’API, le SDK ou l’adresse URL.
- Pour Web Mapping (Cartographie web), Desktop (Bureau) ou Mobile (Mobile), saisissez l’URL de l’application (par exemple,https://<myServer>/myWebMapApp).
- Pour les applications bureautiques, cliquez sur Browse (Parcourir) et sélectionnez le fichier .zip qui contient l’application.
- Cliquez sur Next (Suivant).
- Indiquez un titre.
- Dans My content (Mon contenu), choisissez un dossier dans lequel l’élément doit être enregistré.
Vous pouvez également sélectionner Create new folder (Créer un dossier) dans le menu et entrer un nom de dossier pour enregistrer l’élément dans un nouveau dossier.
Les noms de dossiers ne peuvent pas contenir de caractères Unicode à 4 octets.
- Si votre organisation a configuré des catégories de contenu, cliquez sur Assign categories (Attribuer des catégories) et sélectionnez jusqu’à 20 catégories pour aider les utilisateurs à trouver l’élément.
Vous pouvez également commencer à saisir un nom de catégorie pour affiner la liste des catégories.
- Saisissez des balises qui décrivent l’élément.
Séparez les termes par une virgule (par exemple, Terres fédérales correspond à une balise, alors que Terres, fédérales correspond à deux balises).
Lors de votre saisie, vous pouvez sélectionner n’importe quelle balise affichée. Ces balises vous sont suggérées à partir de celles que vous avez déjà ajoutées.
- Vous pouvez également saisir un résumé qui décrit l’application.
- Cliquez sur Save (Enregistrer).
Une fois l’application ajoutée, elle apparaît dans le contenu. Si vous devez l’inscrire ultérieurement, vous pouvez l’inscrire à partir de l’onglet Settings (Paramètres) de la page de l’élément de l’application. Reportez-vous à la section Ajouter et inscrire une application avec des données d’identification Developer ci-dessous pour plus d’informations.
Vous pouvez configurer les détails de l’élément, joindre du code si nécessaire, et partager l’application si vous disposez de privilèges de partage.
Ajouter et inscrire une application avec des données d’identification Developer
En tant que développeur détenteur d’un compte d’organisation, vous pouvez ajouter et inscrire votre application auprès de la plateforme pour générer un identifiant d’application. Utilisez l’ID d’application dans l’application pour recueillir des statistiques d’utilisation et autoriser les utilisateurs à se connecter à la plateforme avec OAuth 2.0, une structure d’autorisation normalisée. Avec OAuth 2.0, les applications aident l’utilisateur à se connecter à la plateforme via la page de connexion hébergée par cette dernière. Cela permet également à l’application de travailler avec du contenu utilisateur associé à leur organisation. Elle peut en outre utiliser d’autres fonctionnalités d’ArcGIS Online, telles que le géocodage, le calcul d’itinéraire et le GeoEnrichment. Pour en savoir plus sur l’authentification et OAuth 2.0, consultez Esri Developer.
Une autre possibilité consiste à intégrer une clé d’API dans l’application que vous inscrivez.
Les informations d’identification que vous pouvez inclure dans l’application dépendent des privilèges que vous détenez dans l’organisation. Si vous êtes membre du rôle Administration par défaut ou d’un rôle personnalisé disposant du privilège de générer des clés d’API, vous pouvez utiliser soit OAuth 2.0, soit une identification par clé d’API dans votre application. Dans les autres cas, vous ne pouvez utiliser que des informations d’identification Developer OAuth 2.0 dans l’application.
Remarque :
Le modèle d’implémentation concernant les identifiants de connexion des utilisateurs diffère légèrement selon que vous développez une application basée sur le Web ou une application native. Vous trouverez des informations détaillées ainsi que des exemples de codes dans la documentation Esri Developer.
Ajouter et inscrire une application avec des informations d’identification OAuth 2.0 intégrées
Lorsque vous utilisez des informations d’identification OAuth 2.0 avec les applications que vous créez, le jeton d’accès est généré de façon dynamique lorsque quelqu’un accède à l’application. Le jeton d’accès est valide pour 14 jours maximum.
Si votre rôle n’inclut pas le privilège autorisant à créer des clés d’API, procédez comme suit :
- Vérifiez que vous êtes connecté avec un compte d’organisation qui détient les privilèges permettant de créer, mettre à jour et supprimer du contenu.
- Cliquez sur l’onglet My content (Mon contenu) de la page de contenu, puis sur New item (Nouvel élément).
- Dans la fenêtre New item (Nouvel élément), cliquez sur Developer credentials (Informations d’identification Developer).
- Sélectionnez l’option OAuth 2.0 credentials (Informations d’identification OAuth 2.0) et cliquez sur Next (Suivant).
- Sous Redirect URLs (URL de redirection), indiquez l’URL d’accès à une page Web ou à un point de terminaison de serveur qui servira à rediriger les utilisateurs après leur connexion. Cliquez sur Add (Ajouter) pour ajouter d’autres URL de redirection si nécessaire.
Les URL de redirection spécifiées au cours de l’autorisation doivent correspondre à l’une des URL inscrites. Si tel n’est pas le cas, l’autorisation sera rejetée.
Vous pouvez également spécifier la valeur spéciale urn:ietf:wg:oauth:2.0:oob pour les octrois d’autorisation. Dans ce cas, le code d’autorisation est transmis à une URL de portail (/oauth2/approval). En général, cette valeur est utilisée par les applications qui ne possèdent pas de serveur Web ni de structure d’URL personnalisée où le code peut être transmis.
Voici des exemples de format d’URL de redirection pris en charge :
- https://app.foo.com
- urn:ietf:wg:oauth:2.0:oob
- Sous Referrer URLs (URL de référent), indiquez une adresse IP ou une URL de référent autorisée à se connecter. Cliquez sur Add (Ajouter) pour ajouter d’autres adresses IP ou URL de référent si nécessaire.
- Sous Application environment (Environnement de l’application), choisissez un environnement d’application pour l’application : Multiple, Native (Natif), Browser (Navigateur) ou Server (Serveur).
- Dans la zone URL, entrez une URL pour votre application au format https://<myServer>/myWebMapApp.
- Cliquez sur Next (Suivant).
Si vous êtes membre d’un rôle disposant du privilège d’attribuer des applications OAuth 2.0, le fait de cliquez sur Next (Suivant) vous transfère vers une fenêtre dans laquelle vous pouvez définir ce que l’application est autorisée à faire. Si vous ne disposez pas de ce privilège, passez à l’étape 12.
- Choisissez les actions que ces informations d’identifications autoriseront l’application à effectuer en attribuant les privilèges adéquats et cliquez sur Next (Suivant).
La liste des privilèges disponibles dépend de votre abonnement à ArcGIS Location Platform et des privilèges dont vous disposez dans l’organisation. Vous ne pouvez pas accorder des privilèges que votre compte ne détient pas.
Pour plus d’informations sur les types de privilèges, consultez le guide sur la sécurité et l’authentification dans l’aide des développeurs Esri.
- Cliquez sur Browse items (Parcourir les éléments), sélectionnez les éléments auxquels les informations d’identification intégrées vont permettre d’accéder et cliquez sur Add items (Ajouter des éléments).
Vous pouvez également cliquer sur Skip (Ignorer).
- Indiquez un titre.
- Dans My content (Mon contenu), choisissez un dossier dans lequel l’élément doit être enregistré.
Vous pouvez également sélectionner Create new folder (Créer un dossier) dans le menu et entrer un nom de dossier pour enregistrer l’élément dans un nouveau dossier.
Les noms de dossiers ne peuvent pas contenir de caractères Unicode à 4 octets.
- Si votre organisation a configuré des catégories de contenu, cliquez sur Assign categories (Attribuer des catégories) et sélectionnez jusqu’à 20 catégories pour aider les utilisateurs à trouver l’élément.
Vous pouvez également commencer à saisir un nom de catégorie pour affiner la liste des catégories.
- Saisissez des balises qui décrivent l’élément.
Séparez les termes par une virgule (par exemple, Terres fédérales correspond à une balise, alors que Terres, fédérales correspond à deux balises).
Lors de votre saisie, vous pouvez sélectionner n’importe quelle balise affichée. Ces balises vous sont suggérées à partir de celles que vous avez déjà ajoutées.
- Vous pouvez également saisir un résumé qui décrit l’application.
- Cliquez sur Next (Suivant).
- Vérifiez la synthèse des informations d’identification. Pour modifier les paramètres, cliquez sur Back (Retour) et effectuez les modifications avant de créer l’élément.
- Si vous avez accordé des privilèges personnels pour les informations d’identification, cochez la case en regard de la mention de sécurité pour confirmer que vous l’avez lue et que vous l’acceptez, puis cliquez sur Create (Créer) pour créer les informations d’identification.
L’application est ajoutée à votre contenu et sa page d’élément apparaît. Un badge 
indiquant que des informations d’identification OAuth 2.0 sont utilisées avec l’application apparaît sur la page de l’élément ou sur les fenêtres de la page de contenu ou d’aperçu de l’élément lorsque celui-ci est consulté depuis ces objets. Sur l’onglet Overview (Vue d’ensemble) de la page de l’élément, le badge indique si des privilèges personnels sont inclus ou si seuls des privilèges standard sont inclus dans les informations d’identification.
Vous pouvez configurer les détails des éléments de l’application.
Cliquez sur View usage (Afficher l’utilisation) sur l’onglet Settings (Paramètres) pour accéder aux informations indiquant qui s’est connecté à l’application et le nombre de crédits consommés.
Remarque :
La section View usage (Afficher l’utilisation) n’est pas disponible lorsque vous êtes connecté par le biais via un abonnement ArcGIS Location Platform.
Vous pouvez également gérer les paramètres des informations d’identification imbriquées avec l’application.
Ajouter et inscrire une application avec des informations d’identification de clé d’API
Utilisez des informations d’identification de clé d’API lorsque vous devez intégrer les informations d’identification dans l’application et qu’il vous faut une clé valide plus de 14 jours.
Pour ajouter une application et créer une clé d’API intégrée à utiliser pour le processus d’identification, procédez comme suit :
- Vérifiez que vous êtes connecté avec un compte d’organisation qui détient les privilèges permettant de créer des clés d’API, et de créer, mettre à jour et supprimer du contenu.
- Cliquez sur l’onglet My content (Mon contenu) de la page de contenu, puis sur New item (Nouvel élément).
- Dans la fenêtre New item (Nouvel élément), cliquez sur Developer credentials (Informations d’identification Developer).
- Sélectionnez l’option API key credentials (Informations d’identification de clé d’API) et cliquez sur Next (Suivant).
- Utilisez le calendrier pour spécifier une date d’expiration des informations d’identification.
Les informations d’identification peuvent expirer le jour suivant (au minimum) ou jusqu’à 365 jours plus tard (au maximum). Elles expirent à 23:59 à la date d’expiration choisie. L’heure est enregistrée dans le fuseau horaire de votre navigateur lorsque vous ajoutez l’application et générez les informations d’identification.
- Sous Referrer URLs (URL de référent), indiquez l’adresse IP ou l’URL de référent autorisée à se connecter. Cliquez sur Add (Ajouter) pour ajouter d’autres URL ou adresses IP si nécessaire.
Les URL spécifiées au cours de l’autorisation doivent correspondre à l’une des URL inscrites. Si tel n’est pas le cas, l’autorisation sera rejetée.
Voici des exemples de format d’URL de référent pris en charge :
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- Cliquez sur Next (Suivant).
- Choisissez les actions que ces informations d’identifications autoriseront l’application à effectuer en attribuant les privilèges adéquats et cliquez sur Next (Suivant).
La liste des privilèges disponibles dépend de votre abonnement à ArcGIS Location Platform et des privilèges dont vous disposez dans l’organisation. Vous ne pouvez pas accorder des privilèges que votre compte ne détient pas.
Pour plus d’informations sur les types de privilèges, consultez le guide sur la sécurité et l’authentification dans l’aide des développeurs Esri.
- Cliquez sur Browse items (Parcourir les éléments), sélectionnez les éléments auxquels les informations d’identification intégrées vont permettre d’accéder et cliquez sur Add items (Ajouter des éléments).
Vous pouvez également cliquer sur Skip (Ignorer).
- Indiquez un titre.
- Dans My content (Mon contenu), choisissez un dossier dans lequel l’élément doit être enregistré.
Vous pouvez également sélectionner Create new folder (Créer un dossier) dans le menu et entrer un nom de dossier pour enregistrer l’élément dans un nouveau dossier.
Les noms de dossiers ne peuvent pas contenir de caractères Unicode à 4 octets.
- Si votre organisation a configuré des catégories de contenu, cliquez sur Assign categories (Attribuer des catégories) et sélectionnez jusqu’à 20 catégories pour aider les utilisateurs à trouver l’élément.
Vous pouvez également commencer à saisir un nom de catégorie pour affiner la liste des catégories.
- Saisissez des balises qui décrivent l’élément.
Séparez les termes par une virgule (par exemple, Terres fédérales correspond à une balise, alors que Terres, fédérales correspond à deux balises).
Lors de votre saisie, vous pouvez sélectionner n’importe quelle balise affichée. Ces balises vous sont suggérées à partir de celles que vous avez déjà ajoutées.
- Vous pouvez également saisir un résumé qui décrit l’application.
- Cliquez sur Next (Suivant).
- Vérifiez la synthèse des informations d’identification. Pour modifier les paramètres, cliquez sur Back (Retour) et effectuez les modifications avant de créer l’élément.
- Si vous avez accordé des privilèges personnels pour les informations d’identification, cochez la case en regard de la mention de sécurité pour confirmer que vous l’avez lue et que vous l’acceptez, puis cliquez sur Next (Suivant).
- Choisissez de générer la clé d’API immédiatement ou plus tard et cliquez sur Next (Suivant).
Vous devez copier la clé d’API dès qu’elle est générée.
- Si vous cliquez sur l’option Generate the API key and go to item details page. I am ready to copy and save the key. (Générer la clé d’API et accéder à la page des détails de l’élément. Je suis prêt à copier et à enregistrer la clé.), la fenêtre contextuelle Generate API key (Générer une clé d’API) s’affiche lorsque vous cliquez sur Next (Suivant). Cliquez sur le bouton Copy (Copier) pour copier la clé. Collez la clé dans un document sécurisé. Fermez la fenêtre contextuelle lorsque vous avez terminé.
- Si vous cliquez sur l’option Go to item details page. I'll generate the API key later. (Accéder à la page des détails de l’élément. Je générerai la clé d’API ultérieurement.), la page d’élément des informations d’identification apparaît. La page de l’élément apparaît lorsque vous cliquez sur Next (Suivant). Vous pouvez générer la clé d’API depuis l’onglet Settings (Paramètres) de la page de l’élément.
L’application est ajoutée à votre contenu et sa page d’élément apparaît. Un badge 
indiquant qu’une clé d’API est intégrée à l’application apparaît sur la page de l’élément ou sur les fenêtres de la page de contenu ou d’aperçu de l’élément lorsque celui-ci est consulté depuis ces objets. Sur l’onglet Overview (Vue d’ensemble) de la page de l’élément, le badge indique si des privilèges personnels sont inclus ou si seuls des privilèges standard sont inclus dans les informations d’identification.
Vous pouvez configurer les détails des éléments de l’application.
Cliquez sur View usage (Afficher l’utilisation) sur l’onglet Settings (Paramètres) pour accéder aux informations indiquant qui s’est connecté à l’application et le nombre de crédits consommés.
Remarque :
La section View usage (Afficher l’utilisation) n’est pas disponible lorsque vous êtes connecté par le biais via un abonnement ArcGIS Location Platform.
Vous pouvez également gérer les paramètres des informations d’identification imbriquées avec l’application.
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?