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.

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 Zurich OAuth 2.0 avec le ServiceNow SDK.

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

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. Créez un répertoire local pour votre application.
  2. Dans Visual Studio Code, ouvrez le répertoire.
  3. Dans le répertoire de l’application, ouvrez une fenêtre de terminal intégrée.
  4. Spécifiez l’instance à authentifier avec la commande auth . 
    npx @servicenow/sdk auth --add <instance>
    Par exemple :
    npx @servicenow/sdk auth --add https://myinstance.service-now.com
    Remarque : L’utilisation de la commande npx installe le ServiceNow SDK dans votre répertoire d’application plutôt que globalement.
  5. Répondez à la série d’invites suivante.
    Invite Réponse
    Type d’authentification à utiliser Sélectionnez basique.
    Alias pour ces informations d’identification Entrez un alias pour vos informations d’identification et l’instance.

    L’alias peut être utilisé pour l’authentification avec les commandes init, transform, dependencies et install .
    Nom d’utilisateur à authentifier avec l’instance Entrez votre nom d’utilisateur pour l’instance.

    Le rôle administrateur doit vous être affecté.
    Mot de passe pour s’authentifier auprès de l’instance 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 et sont définis comme informations d’identification par défaut.

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 Convertir une application avec le ServiceNow SDK.

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 Zurich 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 Accéder à un rôle privilégié.

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 Importer des données à partir de 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 Zurich 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. Créez un répertoire local pour votre application.
  2. Dans Visual Studio Code, ouvrez le répertoire.
  3. Dans le répertoire de l’application, ouvrez une fenêtre de terminal intégrée.
  4. Spécifiez l’instance à authentifier avec la commande auth . 
    npx @servicenow/sdk auth --add <instance>
    Par exemple :
    npx @servicenow/sdk auth --add https://myinstance.service-now.com
    Remarque : L’utilisation de la commande npx installe le ServiceNow SDK dans votre répertoire d’application plutôt que globalement.
  5. Répondez à la série d’invites suivante.
    Invite Réponse
    Type d’authentification à utiliser Sélectionnez OAuth.
    Alias pour ces informations d’identification Entrez un alias pour vos informations d’identification et l’instance.

    L’alias peut être utilisé pour l’authentification avec les commandes init, transform, dependencies et install .
    Ouvre ServiceNow SDK un navigateur Web pour s’authentifier auprès de l’instance.
  6. Accédez à la page Web qui s’ouvre et connectez-vous à l’instance si vous n’êtes pas connecté.
  7. Sélectionnez Accepter pour autoriser la ServiceNow SDK connexion à l’instance.
    La page s’actualise et inclut un code d’authentification.
  8. Sélectionnez Copier pour copier le code d’authentification fourni.
  9. Dans la ligne de commande, 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 et sont définis comme informations d’identification par défaut.

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 Convertir une application avec le ServiceNow SDK.