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 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).
- Spécifiez un titre.
- Dans My content (Mon contenu), choisissez un dossier dans lequel l’élément doit être enregistré.
- 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 nécessaires pour créer 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.
- 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).
- Spécifiez un titre.
- Dans My content (Mon contenu), choisissez un dossier dans lequel l’élément doit être enregistré.
- 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 les paramètres d’identification sont corrects, cliquez sur Create (Créer).
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.
Vous pouvez configurer les détails des éléments de l’application.
Depuis l’onglet Settings (Paramètres) de la page de l’élément de l’application, vous pouvez afficher des informations sur l’inscription incluant l’ID de l’application (Client ID (ID client)), la clé secrète de l’application (Client Secret (Clé secrète client)) et les environnements de l’application. Vous pouvez mettre à jour l’URL de la source de données ou les URL de redirection, réinitialiser la clé secrète, annuler l’inscription de l’application, et copier ou renouveler le jeton d’application temporaire. Vous pouvez également modifier les privilèges détenus par l’application ainsi que les couches auxquelles elle peut accéder.
Remarque :
Cliquez sur Save (Enregistrer) après chaque modification apportée aux paramètres. La modification de plusieurs paramètres à la fois avant un enregistrement peut avoir pour effet de ne pas enregistrer tous les paramètres.
La réinitialisation de la clé secrète de l’application invalide tous les jetons existants des utilisateurs et des applications émis pour cette application. Les utilisateurs doivent se reconnecter à l’application et les applications configurées avec la clé secrète devront probablement être mises à jour.
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.
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 nécessaires pour créer du contenu et des clés d’API.
- 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.
- 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).
- Spécifiez un titre.
- Dans My content (Mon contenu), choisissez un dossier dans lequel l’élément doit être enregistré.
- 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 les paramètres d’identification sont corrects, cliquez sur Create (Créer).
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.
Vous pouvez configurer les détails des éléments de l’application.
Depuis l’onglet Settings (Paramètres) de la page de l’élément de l’application, vous pouvez afficher des informations sur l’inscription incluant l’ID de l’application (Client ID (ID client)), la clé secrète de l’application (Client Secret (Clé secrète client)) et les environnements de l’application. Vous pouvez mettre à jour les URL de référent, réinitialiser la clé secrète, annuler l’inscription de l’application, et copier ou renouveler le jeton d’application temporaire. Vous pouvez également modifier les privilèges détenus par l’application ainsi que les couches auxquelles elle peut accéder.
Remarque :
Cliquez sur Save (Enregistrer) après chaque modification apportée aux paramètres. La modification de plusieurs paramètres à la fois avant un enregistrement peut avoir pour effet de ne pas enregistrer tous les paramètres.
La réinitialisation de la clé secrète client invalide tous les jetons existants des utilisateurs et des applications émis pour cette application. Les utilisateurs doivent se reconnecter à l’application et les applications configurées avec la clé secrète devront probablement être mises à jour.
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.
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?