Authentification des utilisateurs

ArcGIS Velocity nécessite l’accès à ArcGIS Online pour créer des éléments (tels que des flux et des analyses), exécuter des éléments (un flux depuis une couche d’entités, par exemple) et écrire des entités dans des couches d’entités en sortie. Au lieu de stocker un nom d’utilisateur et un mot de passe, Velocity utilise un jeton d’actualisation ou une clé d’API ArcGIS pour l’authentification et la connexion à ArcGIS Online.

Une clé d’API ArcGIS et un jeton d’actualisation peuvent être inscrits auprès de Velocity. Dans ce cas, Velocity utilise la clé d’API ArcGIS au lieu du jeton d’actualisation. Si une clé d’API ArcGIS expire ou est invalidée, Velocity tente de basculer vers le jeton d’actualisation pour créer et exécuter des éléments.

Mécanismes d’authentification

Les sections qui suivent décrivent le fonctionnement des deux méthodes d’authentification et la façon dont Velocity les utilise.

Jeton d’actualisation

Les jetons d’actualisation sont des jetons d’accès de courte durée (par défaut, deux semaines). Pour garantir que les flux et les analyses puissent s’exécuter pendant plus longtemps, Velocity  offre des mécanismes permettant d’identifier le moment où les jetons d’actualisation arrivent à expiration. Velocity demande et met à jour ces jetons automatiquement.

En savoir plus sur la création d’un jeton d’actualisation

Clé d’API ArcGIS

Les clés d’API ArcGIS sont des jetons d’accès avec une durée de vie supérieure (d’un jour à un an). Vous définissez la valeur d’expiration de la clé d’API ArcGIs lors de sa création. Il est recommandé de définir une valeur d’expiration d’un an. Votre compte d’utilisateur ArcGIS Online doit disposer des privilèges requis pour créer une clé d’API ArcGIS.

En savoir plus sur les considérations et limitations liées à l’utilisation d’une clé d’API ArcGIS

Créer une clé d’API dans ArcGIS Online

Remarque :

Vous devez d’abord créer une clé d’API dans ArcGIS Online, puis l’inscrire auprès de Velocity.

Pour créer une clé d’API, procédez comme suit :

1. Ouvrez ArcGIS Online dans le navigateur et connectez-vous avec vos informations d’identification d’organisation ArcGIS.
2. Dans votre portail, cliquez sur Content (Contenu) > My Content (Mon contenu) > New item (Nouvel élément).

   

3. Cliquez sur Developer credentials (Informations d’identification Developer) > API key credentials (Informations d’identification de clé d’API), puis sur Next (Suivant).

   

4. Sélectionnez l’option Private application that impersonates you (Application privée qui emprunte votre identité), puis cliquez sur Next (Suivant).

   

5. Dans la fenêtre Create developer credentials (Créer des informations d’identification Developer), effectuez les opérations suivantes :
   1. Cliquez sur le paramètre Expiration date (required) (Date d’expiration [obligatoire]), puis définissez la date d’expiration de la clé d’API.

      Remarque :

      La valeur d’expiration minimale est d’un jour et la valeur maximale, d’un an. Il est recommandé de définir une valeur d’expiration d’un an.

   2. Indiquez des valeurs pour le paramètre Referrer URLs (URL de référent), puis cliquez sur Next (Suivant).

      Les URL de référent doivent avoir le format suivant : https://*.arcgis.com.

      

   3. Dans la section Item details (Détails de l’élément), indiquez une valeur pour le paramètre Title (Titre) afin de donner un nom à l’élément de clé d’API, puis cliquez sur Next (Suivant).

      

   4. Cochez la case I understand and acknowledge the capabilities of the selected privileges (Je comprends les capacités accordées par les privilèges sélectionnés et j’atteste en avoir pris connaissance) et cliquez sur Next (Suivant).

      

   5. Indiquez le moment où vous voulez générer une clé d’API, puis cliquez sur Next (Suivant).

      Les options disponibles sont les suivantes :

      • Générer la clé d’API maintenant. Je suis prêt à copier et à enregistrer la clé.
      • Accéder à la page des détails de l’élément. Je générerai la clé d’API ultérieurement.

      

6. Sur la page Generate API key (Générer une clé d’API), copiez la clé d’API générée, puis cliquez sur Close (Fermer).

   Remarque :

   Veillez à copier votre clé d’API, car vous n’y aurez plus accès par la suite.

   

7. Sur la page de détails de l’élément, accédez à Settings (Paramètres) > General (Général) pour ouvrir la page General (Général).

   Il est recommandé d’activer le bouton bascule Deletion management (Gestion des suppressions) pour éviter que l’élément soit supprimé par inadvertance.

   

8. Sur la page General (Général), passez le pointeur sur le texte Expiration pour afficher la date d’expiration complète de la clé d’API.

   La valeur renvoyée se situe dans le fuseau horaire local.

   

Après avoir suivi les étapes ci-dessus, vous avez créé une clé d’API dans ArcGIS Online, que vous pouvez inscrire auprès de Velocity.

En savoir plus sur la création d’informations d’identification par clé d’API dans ArcGIS Online.

Inscrire une clé d’API ArcGIS dans Velocity

Après avoir généré la clé d’API dans ArcGIS Online, vous pouvez l’inscrire auprès de Velocity.

Pour inscrire la clé d’API ArcGIS dans Velocity, procédez comme suit :

1. Ouvrez l’application Velocity dans le navigateur et connectez-vous avec vos identifiants de connexion d’organisation ArcGIS.
2. Cliquez sur le bouton View authentication mechanism (Afficher le mécanisme d’authentification) pour développer le menu déroulant Authentication Mechanism (Mécanisme d’authentification).

   

3. Cliquez sur Update Authentication Mechanism (Mettre à jour le mécanisme d’authentification) pour ouvrir la boîte de dialogue Configure Authentication Mechanism (Configurer le mécanisme d’authentification).
4. Sélectionnez l’option ArcGIS API Key (Clé d’API ArcGIS), puis cliquez sur Next (Suivant).

   

5. Collez la clé d’API que vous avez créée dans la section précédente dans la zone de texte ArcGIS API Key (Clé d’API ArcGIS).
6. Définissez l’option Expiration Date (Date d’expiration) sur le jour que vous avez sélectionné dans la section précédente.
7. Cliquez sur Confirm (Confirmer).

   

   Une fois que vous avez effectué les étapes ci-dessus, vous recevez un message de réussite. Notez que le bouton bascule ArcGIS API Key registered (Clé d’API ArcGIS inscrite) est activé dans le menu déroulant Authentication Mechanism (Mécanisme d’authentification), ce qui indique qu’une clé d’API ArcGIS est inscrite.

   

   En savoir plus sur l’inscription et la création de clés d’API ArcGIS

Considérations et limitations

Lorsque vous utilisez des clés d’API ArcGIS dans Velocity, tenez compte des points suivants :

• À ce stade, Velocity n’envoie pas d’avis par e-mail lorsque la date d’expiration d’une clé d’API ArcGIS approche.

• Dans un compte ArcGIS Online, si l’option API key credentials (Informations d’identification de clé d’API) ne s’affiche pas dans le menu Create developer credentials (Créer des informations d’identification Developer), cela signifie que votre compte ne dispose peut-être pas des privilèges requis. Votre compte doit disposer des privilèges de création et d’affectation d’autorisations aux informations d’identification de clé d’API.

  Vous pouvez modifier les privilèges généraux sur la page Member roles (Rôles des membres). Pour ouvrir la page Member roles (Rôles des membres), accédez à Organization (Organisation) > Settings (Paramètres) > Member roles (Rôles des membres).

  Dans la section Manage roles (Gérer les rôles), sous Member roles (Rôles des membres), vous pouvez voir tous les rôles qui existent dans ArcGIS Online. Cliquez sur le bouton More options (Autres options) en regard du rôle, puis sélectionnez l’option Edit (Mettre à jour) pour ouvrir la fenêtre Edit role (Mettre à jour le rôle).

  

  Dans la fenêtre Edit role (Mettre à jour le rôle), développez General privileges (Privilèges généraux) > Content (Contenu), puis activez les boutons bascule Generate API keys (Générer des clés d’API) et Assign privileges to OAuth 2.0 applications (Attribuer des privilèges aux applications OAuth 2.0) pour créer et affecter une autorisation à des informations d’identification de clé d’API.

  

  Remarque :

  Si ces privilèges sont manquants, demandez à l’administrateur de l’organisation de mettre à jour votre rôle avec les autorisations requises.

• Le compte d’utilisateur doit avoir accès aux éléments Velocity pour pouvoir utiliser une clé d’API créée par cet utilisateur dans Velocity<