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écouverte > Informations d'identification.
2. Sélectionnez Nouveau.
3. Sélectionnez les informations d’identification CloudFoundry.
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.
   Commande	Ordre dans lequel la plateforme teste ces informations d’identification lorsqu’elle tente de se connecter aux appareils. Un nombre plus faible indique que les informations d’identification semblent plus haut dans la liste. Établissez l’ordre des informations d’identification lors de l’utilisation d’un grand nombre d’informations d’identification ou lorsque la sécurité verrouille les utilisateurs après trois tentatives de connexion infructueuses. 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 s’affiche si la plateforme détecte des espaces de début ou de fin 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 le déverrouiller.

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 « Accepter : application/json » -H « Autorisation : porteur<INSÉRER UN JETON ICI> »

   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 des ServiceNow informations d’identification.

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

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

• –/v3/organisations
• –/v3/espaces
• –/v3/domaines
• –/v3/routes
• –/v3/organization_quotas
• –/v3/space_quotas
• –/v3/apps
• -/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écouverte sans serveur

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

   Tableau 1. Formulaire Calendrier Découverte

   Champ	Description
   Nom	Entrez un nom unique et descriptif pour ce calendrier Découverte, 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écouverte, 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	Saisissez 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 Schémas d’exécution sans serveur et sélectionnez Enregistrer.
9. Sélectionnez l’onglet Schémas 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écouverte

    Paramètre	Description
    Organisation	Nom de l’organisation qui doit être détectée, ou toutes 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 du 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écouverte, accédez à la définition de Serverless Découverte 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 n’est pas actif.

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 Pattern.

Données collectées par Découverte 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écouverte de la section d’extension BOSH.