Ajouter et inscrire une application

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.

  1. 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.
  2. Depuis l’onglet My content (Mon contenu) de la page de contenu, cliquez sur New item (Nouvel élément), puis sur Application (Application).
  3. 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.
  4. Pour Web Mapping (Cartographie web), Desktop (Bureau) ou Mobile (Mobile), saisissez l’URL de l’application (par exemple,https://<myServer>/myWebMapApp).
  5. Pour les applications bureautiques, cliquez sur Browse (Parcourir) et sélectionnez le fichier .zip qui contient l’application.
  6. Cliquez sur Next (Suivant).
  7. Indiquez un titre.
  8. 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.

  9. Si l’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.

  10. 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.

  11. Vous pouvez également saisir un résumé qui décrit l’application.
  12. 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.

Créer des éléments d’informations d’identification Developer

En tant que développeur détenteur d’un compte d’organisation, créez un élément d’informations d’identification Developer pour générer un ID 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.

Vous pouvez également créer des informations d’identification Developer pour l’authentification de l’application et pour la génération de clés d’API.

Le type d’informations d’identification Developer que vous créez dépend 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 les autres cas, vous ne pouvez utiliser que des informations d’identification Developer OAuth 2.0.

Une fois les informations d’identification Developer créées, cliquez sur View usage (Afficher l’utilisation) dans l’onglet Settings (Paramètres) de la page d’élément de l’application pour accéder aux informations indiquant qui s’est connecté à l’application et le nombre de crédits consommés. Vous pouvez également gérer les paramètres des informations d’identification intégrées dans l’application.

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.

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.

Créer des informations d’identification OAuth 2.0 pour l’authentification de l’utilisateur

Si votre application exige des utilisateurs qu’ils se connectent avec un compte ArcGIS Online, procédez comme suit :

  1. 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.
  2. Cliquez sur l’onglet My content (Mon contenu) de la page de contenu, puis sur New item (Nouvel élément).
  3. Dans la fenêtre New item (Nouvel élément), cliquez sur Developer credentials (Informations d’identification Developer).

    La première fenêtre qui vous est présentée dépend des privilèges que vous détenez dans l’organisation. Si vous appartenez à un rôle qui n’inclut pas le privilège autorisant à créer des clés d’API, passez à l’étape 5. Si votre rôle permet de créer des clés d’API, passez à l’étape 4.

  4. Sélectionnez l’option OAuth 2.0 credentials—For user authentication (Informations d’identification OAuth 2.0 pour l’authentification de l’utilisateur) et cliquez sur Next (Suivant).
  5. 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

  6. Dans la zone URL, entrez une URL pour votre application au format https://<myServer>/myWebMapApp.
  7. Cliquez sur Next (Suivant).
  8. Indiquez un titre.
  9. 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.

  10. Si l’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.

  11. 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.

  12. Vous pouvez également saisir un résumé qui décrit l’application.
  13. Cliquez sur Next (Suivant).

    Le résumé des informations d’identification s’affiche.

  14. 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.
  15. Cliquez sur Create (Créer).

L’application est ajoutée à votre contenu et sa page d’élément apparaît. Un badge OAuth 2.0 credentials (Informations d’identification OAuth 2.0) 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.

Créer des informations d’identification OAuth 2.0 pour l’authentification de l’application

Si votre application publique n’exige pas que les utilisateurs se connectent et qu’elle génère des jetons d’accès côté serveur, procédez comme suit :

  1. 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.
  2. Cliquez sur l’onglet My content (Mon contenu) de la page de contenu, puis sur New item (Nouvel élément).
  3. Dans la fenêtre New item (Nouvel élément), cliquez sur Developer credentials (Informations d’identification Developer).

    La première fenêtre qui vous est présentée dépend des privilèges que vous détenez dans l’organisation. Si vous appartenez à un rôle qui n’inclut pas le privilège autorisant à créer des clés d’API, passez à l’étape 5. Si votre rôle permet de créer des clés d’API, passez à l’étape 4.

  4. Sélectionnez l’option OAuth 2.0 credentials—For app authentication (Informations d’identification OAuth 2.0 pour l’authentification de l’application) et cliquez sur Next (Suivant).
  5. Sous Where will you use these credentials (Où utiliserez-vous ces informations d’identification ?), choisissez l’une des options suivantes :
    • Private application with the selected privileges and access (Application privée avec des privilèges et accès définis) : choisissez cette option pour accorder l’accès à n’importe quel ensemble d’éléments et de privilèges. Vous pouvez intégrer ces informations d’identification dans une application privée ou dans un composant côté serveur utilisé par une application publique.
    • Private application that impersonates you (Application privée qui emprunte votre identité) : choisissez cette option pour accorder tous vos privilèges actuels, ainsi que vos accès au contenu, aux membres et aux paramètres de l’organisation.
  6. Cliquez sur Next (Suivant).
  7. Si vous avez sélectionné Private application with the selected privileges and access (Application privée avec des privilèges et accès définis), vous pouvez également choisir l’une des options suivantes :
    • No items access (Aucun accès aux éléments) : aucun accès aux éléments n’est requis pour ces informations d’identification. Cliquez sur Next (Suivant).
    • Grant item access using privileges (Accorder l’accès aux éléments via des privilèges) : des privilèges doivent obligatoirement être sélectionnés pour accéder aux éléments de ces informations d’identification. Cliquez sur Next (Suivant).
    • Grant access to specific items (Accorder l’accès à des éléments spécifiques) : vous devez d’abord sélectionner les éléments dont vous êtes propriétaire et qui accorde l’accès. Cliquez sur Next (Suivant).
  8. Si vous avez sélectionné Private application with the selected privileges and access (Application privée avec des privilèges et accès définis), vous pouvez également attribuer des privilèges afin de déterminer les actions que les informations d’identification permettront à l’application d’effectuer. Cliquez sur Next (Suivant).

    La liste des privilèges disponibles dépend de si vous êtes abonné à 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.

  9. Cliquez sur Next (Suivant).
  10. 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 est 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

  11. Cliquez sur Next (Suivant).
  12. Indiquez un titre.
  13. 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.

  14. Si l’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.

  15. 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.

  16. Vous pouvez également saisir un résumé qui décrit l’application.
  17. Cliquez sur Next (Suivant).

    Le résumé des informations d’identification s’affiche.

  18. 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.
  19. Si vous avez sélectionné Private application that impersonates you (Application privée qui emprunte votre identité), cochez la case à côté de I acknowledge and accept the security requirements associated with the selected privileges (J’atteste avoir pris connaissance des exigences de sécurité relatives aux privilèges sélectionnés et les accepter).
  20. Cliquez sur Create (Créer).

L’application est ajoutée à votre contenu et sa page d’élément apparaît. Un badge OAuth 2.0 credentials (Informations d’identification OAuth 2.0) indiquant les informations d’identification OAuth 2.0 apparaît lorsque l’élément est affiché à partir des fenêtres de la page de contenu ou d’aperçu de l’élément. Dans l’onglet Overview (Vue d’ensemble) de la page d’élément, le badge OAuth 2.0 Credentials - Impersonates Item owner (Informations d’identification OAuth 2.0 – Emprunter l’identité du propriétaire de l’élément) apparait si vous avez choisi Private application that impersonates you (Application privée qui emprunte votre identité) sous Where will you use these credentials (Où utiliserez-vous ces informations d’identification ?).

Créer des informations d’identification de clé d’API

Pour créer des informations d’identification de clé d’API, procédez comme suit :

  1. 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.
  2. Cliquez sur l’onglet My content (Mon contenu) de la page de contenu, puis sur New item (Nouvel élément).
  3. Dans la fenêtre New item (Nouvel élément), cliquez sur Developer credentials (Informations d’identification Developer).
  4. Sélectionnez l’option API key credentials (Informations d’identification de clé d’API) et cliquez sur Next (Suivant).
  5. Sous Where will you use these credentials (Où utiliserez-vous ces informations d’identification ?), choisissez l’une des options suivantes :
    • Public application (Application publique) : choisissez cette option pour accorder l’accès à des éléments et privilèges de service spécifiques.
    • Private application with the selected privileges and access (Application privée avec des privilèges et accès définis) : choisissez cette option pour accorder l’accès à n’importe quel ensemble d’éléments et de privilèges. Vous pouvez intégrer ces informations d’identification dans une application privée ou dans un composant côté serveur utilisé par une application publique.
    • Private application that impersonates you (Application privée qui emprunte votre identité) : choisissez cette option pour accorder tous vos privilèges actuels, ainsi que vos accès au contenu, aux membres et aux paramètres de l’organisation.
  6. Cliquez sur Next (Suivant).
  7. Si vous avez sélectionné Public application (Application publiqiue), choisisez l’une des options suivantes :
    • No items access (Aucun accès aux éléments) : aucun accès aux éléments n’est requis pour ces informations d’identification. Cliquez sur Next (Suivant).
    • Grant access to specific items (Accorder l’accès à des éléments spécifiques) : vous devez d’abord sélectionner les éléments dont vous êtes propriétaire, puis cliquer sur Next (Suivant).
  8. Si vous avez sélectionné Private application with the selected privileges and access (Application privée avec des privilèges et accès définis), vous pouvez également choisir l’une des options suivantes :
    • No items access (Aucun accès aux éléments) : aucun accès aux éléments n’est requis pour ces informations d’identification. Cliquez sur Next (Suivant).
    • Grant item access using privileges (Accorder l’accès aux éléments via des privilèges) : des privilèges doivent obligatoirement être sélectionnés pour accéder aux éléments de ces informations d’identification. Cliquez sur Next (Suivant).
    • Grant access to specific items (Accorder l’accès à des éléments spécifiques) : vous devez d’abord sélectionner les éléments dont vous êtes propriétaire, puis cliquer sur Next (Suivant).
  9. Si vous avez sélectionné Public application (Application publique) ou Private application with the selected privileges and access (Application privée avec des privilèges et accès définis), vous pouvez également attribuer des privilèges afin de déterminer les actions que les informations d’identification permettront à l’application d’effectuer. 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.

  10. Si vous avez sélectionné Private application that impersonates you (Application privée qui emprunte votre identité), vous pouvez également utiliser le calendrier pour indiquer 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 h 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.

  11. 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 est 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

  12. Cliquez sur Next (Suivant).
  13. Indiquez un titre.
  14. 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.

  15. Si l’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.

  16. 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.

  17. Vous pouvez également saisir un résumé qui décrit l’application.
  18. Cliquez sur Next (Suivant).

    Le résumé des informations d’identification s’affiche.

  19. 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.
  20. Si vous avez sélectionné Private application that impersonates you (Application privée qui emprunte votre identité), cochez la case à côté de I acknowledge and accept the security requirements associated with the selected privileges (J’atteste avoir pris connaissance des exigences de sécurité relatives aux privilèges sélectionnés et les accepter).
  21. Cliquez sur Create (Créer).

L’application est ajoutée à votre contenu et sa page d’élément apparaît. Un badge API key credentials (Informations d’identification de clé d’API) 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.

Rubriques connexes