L’authentification auprès d’une ServiceNow instance avec le ServiceNow SDK

Authentifiez-vous auprès d’une ServiceNow instance et stockez les informations d’identification de l’utilisateur pour accéder à l’instance sur votre système avec le ServiceNow SDK.

Après avoir installé le ServiceNow SDK, vous pouvez vous authentifier auprès d’une instance à l’aide de l’interface ServiceNow SDK de ligne de commande (CLI) pour commencer à développer des applications et à les déployer sur votre instance. Une instance de non-production doit être utilisée pour le développement d’applications.

Vous pouvez utiliser des informations d’identification de base ou OAuth 2.0 pour vous authentifier sur une instance. Pour utiliser l’authentification OAuth 2.0, votre instance doit avoir ServiceNow IDE (version 1.1 ou ultérieure) installée ou avoir la configuration XML requise importée. Par défaut, les instances de la version incluent ServiceNow IDE la version 1.1.4 et prennent en charge l’authentification Yokohama OAuth 2.0 avec le ServiceNow SDK.

Authentifiez-vous sur une instance à l’aide de l’authentification ServiceNow de base avec le ServiceNow SDK

Utilisez l’authentification de base pour vous connecter à une ServiceNow instance avec le ServiceNow SDK.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Cette procédure utilise l’interface de ligne de ServiceNow SDK commande (CLI). À partir d’un outil en ligne de commande, entrez now-sdk -- help pour obtenir des informations sur les commandes disponibles et les options globales. Pour obtenir des informations supplémentaires sur une commande et ses paramètres, entrez la commande et --help ou -h. Par exemple, now-sdk auth --help. Pour plus d’informations sur l’interface de ligne de commande, reportez-vous à ServiceNow SDK CLI.

Procédure

1. Ouvrez un outil en ligne de commande sur votre système.
2. Spécifiez l’instance à authentifier avec la commande auth .

   now-sdk auth save <alias> --type basic

   Par exemple :

   now-sdk auth save devuser1 --type basic --default true

3. À l’invite, entrez l’URL de l’instance cible.
4. Entrez votre ServiceNow nom d’utilisateur.

   Le rôle administrateur doit vous être affecté.

5. Entrez votre mot de passe.

Résultats

L’alias et les informations d’identification sont stockés dans le trousseau d’appareils ou le gestionnaire d’informations d’identification sur votre système. L’alias peut être utilisé pour l’authentification à l’aide des commandes create, convert, fetch et deploy .

Que faire ensuite

Créez une application incluse dans le périmètre ou convertissez une application existante pour l’utiliser avec le ServiceNow SDK. Pour en savoir plus, reportez-vous Créer une application avec le ServiceNow SDK à la section ou .

Configurez une ServiceNow instance pour l’authentification OAuth 2.0 avec le ServiceNow SDK

Importez la configuration pour utiliser l’authentification OAuth 2.0 avec le ServiceNow SDK vers une instance.

Avant de commencer

Important :

Cette procédure n’est requise que pour les instances sur lesquelles (version 1.1 ou ultérieure) n’est pas ServiceNow IDE installée. Par défaut, les instances de la version incluent ServiceNow IDE la version 1.1.4 et prennent en charge l’authentification Yokohama OAuth 2.0 avec le ServiceNow SDK.

L’utilisateur administrateur système (admin) par défaut doit s’élever au rôle de security_admin privilégié pour configurer une instance pour l’authentification OAuth 2.0 avec le ServiceNow SDK. Pour plus d'informations, consultez Elevate to a privileged role.

Rôle requis : security_admin

Procédure

1. Accédez à l’article Configuration du SDK ServiceNow pour l’authentification OAuth 2.0 (SSO) dans le ServiceNow Community.
2. Téléchargez le fichier ZIP joint et décompressez son contenu.
3. Importez le code XML dans votre instance.
   1. Depuis votre instance, accédez à une liste.
      N’importe quelle liste peut être utilisée, car le fichier XML contient le nom de table de destination pour les enregistrements.
   2. Sélectionnez et maintenez enfoncé (ou cliquez avec le bouton droit de la souris) sur n’importe quel titre de colonne et sélectionnez Importer XML.
   3. Dans le formulaire Importer XML, sélectionnez Choisir un fichier et sélectionnez l’un des fichiers XML téléchargés.
   4. Sélectionnez Charger.
   5. Répétez ces étapes pour chaque fichier XML.
   Pour en savoir plus, consultez Import data from XML.

Résultats

Les développeurs peuvent s’authentifier sur l’instance à l’aide d’OAuth 2.0 avec le .ServiceNow SDK

Authentifiez-vous auprès d’une ServiceNow instance à l’aide d’OAuth 2.0 avec le ServiceNow SDK

Utilisez l’authentification OAuth 2.0 pour vous connecter à une ServiceNow instance avec le ServiceNow SDK.

Avant de commencer

Pour utiliser l’authentification OAuth 2.0, votre instance doit avoir ServiceNow IDE (version 1.1 ou ultérieure) installée ou avoir la configuration XML requise importée. Par défaut, les instances de la version incluent ServiceNow IDE la version 1.1.4 et prennent en charge l’authentification Yokohama OAuth 2.0 avec le ServiceNow SDK. Pour plus d'informations, consultez Configurez une ServiceNow instance pour l’authentification OAuth 2.0 avec le ServiceNow SDK.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Cette procédure utilise l’interface de ligne de ServiceNow SDK commande (CLI). À partir d’un outil en ligne de commande, entrez now-sdk -- help pour obtenir des informations sur les commandes disponibles et les options globales. Pour obtenir des informations supplémentaires sur une commande et ses paramètres, entrez la commande et --help ou -h. Par exemple, now-sdk auth --help. Pour plus d’informations sur l’interface de ligne de commande, reportez-vous à ServiceNow SDK CLI.

Procédure

1. Ouvrez un outil en ligne de commande sur votre système.
2. Spécifiez l’instance à authentifier avec la commande auth .

   now-sdk auth save <alias> --type oauth

   Par exemple :

   now-sdk auth save devuser1 --type oauth --default true

3. À l’invite, entrez l’URL de l’instance cible.
   Ouvre ServiceNow SDK un navigateur Web pour s’authentifier avec l’instance.
4. Accédez à la page Web qui s’ouvre et connectez-vous à l’instance si vous n’êtes pas connecté.
5. Sélectionnez Accepter pour autoriser la ServiceNow SDK connexion à l’instance.
   La page s’actualise et inclut un code d’authentification.
6. Sélectionnez Copier pour copier le code d’authentification fourni.
7. Dans l’outil en ligne de commande de votre système, collez le code d’authentification.

Résultats

L’alias et les informations d’identification sont stockés dans le trousseau d’appareils ou le gestionnaire d’informations d’identification sur votre système. L’alias peut être utilisé pour l’authentification à l’aide des commandes create, convert, fetch et deploy .

Que faire ensuite

Créez une application incluse dans le périmètre ou convertissez une application existante pour l’utiliser avec le ServiceNow SDK. Pour en savoir plus, reportez-vous Créer une application avec le ServiceNow SDK à la section ou .