Demander des applications dans l'App Store

Visitez le site Web ServiceNow Store pour découvrir toutes les applications disponibles et pour obtenir des informations sur la procédure à suivre pour soumettre des demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Storenotes de publication relatives à l'historique des versions.

Prérequis

Informations d'identification Pivotal Cloud Foundry

Créez les informations d’identification Pivotal Cloud Foundry .

1. Accédez à la Détection > Identifiants.
2. Sélectionnez Nouveau.
3. Sélectionnez Informations d’identification Cloud Foundry.
4. Renseignez les champs suivants du formulaire :

   Champ	Description
   Nom	Nom des informations d'identification. Par exemple, pcf_user credentials
   Actif	Option permettant la détection de ces informations d'identification. Cochez cette case pour activer la détection.
   S'applique à	Les informations d'identification que vous souhaitez appliquer ou non à Tous les serveurs MID de votre réseau, ou à un ou plusieurs MID Servers spécifiques. Sélectionnez MID Servers spécifiques.
   Ordre	Ordre selon lequel la plateforme essaie ces informations d’identification lorsqu’elle tente de se connecter aux appareils. Un nombre plus petit indique que les informations d’identification apparaissent plus haut dans la liste. Établissez un ordre pour les informations d’identification lorsque vous utilisez des informations d’identification avec des nombres élevés ou lorsque la sécurité verrouille les utilisateurs après trois tentatives de connexion échouées. Si toutes les informations d'identification ont le même numéro d'ordre (ou n'en ont pas), l'instance les essaie de manière aléatoire. La valeur par défaut est 100.
   Noms d'utilisateur	Nom de l'utilisateur de ces informations d'identification. Évitez les espaces blancs dans les noms d'utilisateur. Un avertissement apparaît si la plateforme détecte des espaces blancs dans le nom d’utilisateur. Par exemple, pcf_user. Utilisez l'élément client_id qui permet de générer le jeton JWT.
   Mot de passe	Mot de passe pour l'utilisateur de ces informations d'identification. Utilisez l'élément client_secret qui permet de générer le jeton JWT.
   Alias d'identification	Autre nom pour ces informations d'identification. Par exemple, cf. Si ce champ est fermé, sélectionnez l’icône de déverrouillage pour déverrouiller le champ.

5. Sélectionnez Mettre à jour.

Informations d'identification de jeton Web JSON

Pour vérifier le jeton Web JSON (JWT), effectuez les étapes de validation de jeton suivantes.

Le format du jeton JWT est : https://docs.cloudfoundry.org/api/uaa/version/4.27.0/index.html#jwt-bearer-token-grant

1. Exécutez le script cURL suivant par rapport à l'API de serveur User Account and Authentication (UAA) et vérifiez les résultats :

   curl -s -k https://ip_address:port/oauth/token -X; POST -H ”Content-Type: application/x-www-form-urlencoded” -H “Accept: application/json” -d “client_id=<INSERT_USER_HERE>&client_secret=<INSERT_PASS_HERE>&grant_type=client_credentials&token_format=jwt&response_type=token”

   Si cette commande ne génère pas de jeton, vérifiez que les informations d’identification dans le référentiel sont correctes, sinon passez à l’étape ServiceNow 2.

2. Exécutez le script cURL suivant par rapport à l'API Pivotal Cloud Foundry :

   curl https ://ip_address :port/v3/spaces -k -v -H « Accept : application/json » -H « Authorization : bearer<INSERT TOKEN HERE> »

   Si cette commande ne récupère pas les informations sur les espaces PCF, vérifiez les informations d’identification dans le référentiel d’informations d’identification ServiceNow .

Informations d’identification pour les éléments d’API V3

Attribuez à un utilisateur en lecture seule l’autorisation d’utiliser les éléments d’API suivants :

• –/v3/organisations
• –/v3/espaces
• –/v3/domaines
• –/v3/routes
• –/v3/organization_quotas
• –/v3/space_quotas
• –/v3/applications
• -/v3/service_offerings
• -/v3/service_plans
• -/v3/service_instances
• -/v3/gouttelettes

Remarque :

Le Pivotal Cloud Foundry modèle prend également en charge les API PCF V2.

Créer un calendrier Détection sans serveur

1. Accédez à la Détection > Calendriers de détection.
2. Sélectionnez Nouveau.
3. Renseignez les champs suivants du formulaire :

   Tableau 1. Formulaire Calendrier Détection

   Champ	Description
   Nom	Entrez un nom unique et descriptif pour ce calendrier Détection, par exemple pcf
   Détecter	Pour le type de détection, sélectionnez Sans serveur
   Serveur MID	Serveurs MID auxquels les informations d'identification s'appliquent. Spécifiez les Serveur MID requis, par exemple Discovery_Server
   Actif	Option permettant la détection de ces informations d'identification. Cochez cette case pour activer Discovery.
   Alias d'identification	Autre nom pour ces informations d'identification. Utilisez l’alias associé aux informations d’identification Pivotal Cloud Foundry que vous avez créées précédemment.

4. Cliquez avec le bouton droit sur l'en-tête du formulaire Calendrier Détection, puis sélectionnez Enregistrer.

   

5. Sélectionnez l'onglet Modèles d'exécution sans serveur.
6. Sélectionnez Nouveau.
7. Renseignez les champs suivants du formulaire :

   Tableau 2. Formulaire Modèle d'exécution sans serveur

   Champ	Description
   Nom	Entrez un nom unique et descriptif pour ce modèle d’exécution sans serveur, par exemple, pcf1
   Modèle	Sélectionnez Cloud Foundry.
   Hôte proxy	Nom de domaine complet de l’ordinateur sur lequel vous installez le serveur proxy. Spécifiez Global.
   Actif	Cochez la case pour activer ce calendrier de détection. Cochez cette case.

8. Cliquez avec le bouton droit sur l’en-tête du formulaire Modèles d’exécution sans serveur, puis sélectionnez Enregistrer.
9. Sélectionnez l’onglet Modèles d’exécution sans serveur
10. Créez et définissez le modèle d'exécution sans serveur conformément à la description de la documentation du produit.
    Configurez les paramètres requis par le Pivotal Cloud Foundry modèle comme suit :

    Tableau 3. Paramètres du lanceur de modèle Détection

    Paramètre	Description
    Organisation	Nom de l’organisation qui doit être détectée, ou tous les éléments où l’entrée est « * ».
    credential_alias	Autre nom pour ces informations d'identification. Utilisez l’alias associé aux informations d’identification Pivotal Cloud Foundry que vous avez créées précédemment.
    URL_CF	URL de l’API du contrôleur dans le cloud utilisé pour récupérer les informations à partir de Pivotal Cloud Foundry.
    URL_CF_AUTH	API de serveur UAA​utiliséee pour générer le jeton. Entrez la valeur au format suivant : https://uaa.sys.dev.phx.pcf.example.com/oauth/token

11. Mettre à jour.
12. Pour démarrer la détection, accédez à la définition sans serveur Détection et sélectionnez Détecter maintenant.

Fonctions de fermeture EVAL

Utilisez les fonctions de fermeture EVAL suivantes pour concaténer toutes les organisations en utilisant « , » comme séparateur.

var rtrn = ’’;
var organizations = ${organizations[*].name};
var beforeReturn = ’’;
var separator = ’’;
for (var i = 0; i < organizations.size(); i++)   
	{
	beforeReturn += separator + organizations.get(i);  
	separator = ',';   
	}
rtrn = beforeReturn;

Utilisez les fonctions de fermeture suivantes EVAL pour renvoyer 1 si l’état opérationnel est actif et 2 s’il est inactif.

var rtrn = '';
var currentOrgStatus = ${organizations[].operational_status};
var status = currentOrgStatus.toLowerCase();
if(status == "active"){  
   rtrn = "1";  
}
else { 
   rtrn = "2";
}

Utilisez la fonction de fermeture suivante EVAL pour renvoyer 1 si l’état opérationnel est démarré et 2 s’il n’est pas démarré.

var rtrn = '';
var currentAppStatus = ${apps[].state};
var status = currentAppStatus.toLowerCase();
if(status == "started"){
   rtrn = "1";  
}
else {   
   rtrn = "2";   
}

Obtenir un appel Cloud Foundry

L'opération personnalisée Obtenir un appel Cloud Foundry gère la génération de jetons. Elle utilise les informations d'identification et la variable de contexte URL_CF_AUTH pour générer un jeton utilisé pour créer des appels API.

Lorsqu'un jeton est généré, l'élément URL_CF est utilisé pour créer les appels API définis dans le champ Ressource. L'opération personnalisée gère également la pagination lorsque laquelle la réponse s'étend sur plus d'une page.

L'opération Obtenir un appel Cloud Foundry analyse l'entrée JSON pour remplir les tables et les variables.

Pivotal Cloud Foundry Section d’extension BOSH

Le Pivotal Cloud Foundry BOSH est une section d’extension du Pivotal Cloud Foundry modèle.

Données collectées par Détection lors d'une détection horizontale

Relations CI

Ces relations sont créées pour prendre en charge la détection d'Pivotal Cloud Foundry.

Pivotal Cloud Foundry Relations BOSH

Ces relations sont créées pour prendre en charge Pivotal Cloud Foundry la détection de la section d’extension BOSH.