Création de jetons de service côté A

Un jeton de service est une clé Equinix Fabric unique qui permet l'accès à une ressource d'interconnexion.

Un jeton de service côté A permet à un utilisateur ou un client d'établir une connexion entre votre port Fabric et d'autres destinations sur Fabric. Il permet une utilisation agrégée de votre port Fabric côté A et vous dispense, en tant que fournisseur ou revendeur, de connaître les exigences spécifiques à chaque connexion.

Créez un jeton de service côté A pour autoriser l'utilisation de votre port Equinix Fabric et permettre à vos utilisateurs ou clients de se connecter à des fournisseurs infonuagiques, des opérateurs de réseau ou toute autre destination Equinix Fabric . En tant que propriétaire du port côté A, vous êtes facturé pour les connexions virtuelles mises en place par vos utilisateurs ou clients qui utilisent vos jetons côté A.

remarque

Si un jeton de service côté A vous a été communiqué par un fournisseur, un revendeur, un opérateur ou un fournisseur de services, consultez Utilisation d'un jeton côté A.

Pour créer un jeton de service, vous devez avoir:

• Un compte Equinix Fabric, avec l'un des rôles: Fabric Manager, Fabric Connection Manager, Fabric Service Provider, Fabric Service Profile Manager ou End Customer Fabric Manager.
• Autorisations d'accès au port pour lequel vous souhaitez créer un jeton de service.
• Si vous utilisez l'API, authentifiez-vous en échangeant votre identifiant client et votre clé secrète client contre un jeton d'accès. Consultez la documentation relative à l'authentification de l'API (Authentification de l'API) pour plus d'informations.

Options de jetons côté A

Réglages de connexion:

• VLAN: selon le type de port, vous devez fournir les informations d’encapsulation et de VLAN nécessaires à la connexion. Si vous utilisez un port Dot1q, indiquez l’identifiant du VLAN. Si vous utilisez un port QinQ, indiquez les balises S et C du VLAN.

• Bande passante maximale: spécifiez la largeur de bande maximale de la connexion. Votre utilisateur ou client peut configurer la vitesse de connexion jusqu'à cette limite.

• Autoriser les connexions distantes: indiquez si vous autorisez les connexions distantes à votre port. Si vous les autorisez, vos utilisateurs ou clients peuvent établir des connexions aboutissant à une région métropolitaine différente de celle de votre port. Si vous n’autorisez pas les connexions à distance, les connexions sont limitées aux destinations situées dans la même région métropolitaine que votre port.

Réglages du jeton de service:

• Expiration - Vous devez définir une date d'expiration pour le jeton de service. Votre client ou utilisateur doit utiliser ce jeton pour établir une connexion avant cette date. Si le jeton expire, il ne pourra plus être utilisé pour établir une connexion et vous devrez en générer un nouveau.

• Destinataires du jeton de service: envoyez le jeton de service à un maximum de 12 destinataires par e-mail. Un jeton est à usage unique ; un seul destinataire peut l’utiliser.

Créer un jeton de service

Portal

Pour créer un jeton de service côté A :

1. Connectez-vous au [Portail client > Tableau de bord en tissu.

2. Dans le menu Jetons de service, sélectionnez Créer un jeton de service.

Type de jeton de service

1. Dans la section Type de jeton de service, sélectionnez A-Jeton de service côté.

2. Dans la section Actif côté A, Port est automatiquement sélectionné.

   

3. Cliquez sur + Sélectionner un port, choisissez un port dans la liste des ports disponibles du projet actuel. Cliquez sur Sélectionner un port.

   

   Cliquez sur Suivant.

   Paramètres de connexion

   Dans les Paramètres de connexion:

4. Entrez les informations VLAN pour votre port.

5. Sélectionnez la largeur de bande maximale pour les connexions de votre port.

6. Pour autoriser les connexions à distance, cochez la case Autoriser les connexions à distance.

Réglages du jeton de service

Dans les Paramètres du jeton de service:

1. Entrez ou choisissez une date d'expiration pour le jeton de service. La durée maximale d'expiration est de 90 jours.

   

2. Veuillez entrer les adresses courriel des utilisateurs qui recevront ce jeton de service. Ce jeton ne peut être utilisé qu'une seule fois par destinataire.

   

   Cliquez sur Suivant.

   Examen

   Vérifiez les informations du jeton de service dans les sections Type de jeton de service, Paramètres de connexion et Paramètres du jeton de service. Si vous devez modifier ces renseignements, cliquez sur Retour.

   Une fois que vous avez créé un jeton de service côté A et que vous l'avez partagé avec votre utilisateur ou client, celui-ci a l'autorisation complète d'établir une connexion à partir du port défini par ce jeton. En tant que créateur du jeton côté A et propriétaire du port, vous êtes facturé pour la connexion établie par votre utilisateur ou client.

   Lorsque les informations du jeton de service sont correctes, cliquez sur Créer un jeton de service.

   

API

Pour créer un jeton de service côté client, envoyez une requête POST au point de terminaison /fabric/v4/serviceTokens. Indiquez les paramètres de votre jeton de service, vos paramètres de connexion et les détails du port dans le corps de la requête.

Réglages du jeton de service

• expirationDateTime - Specify the expiration date for your service token in ISO 8601 datetime format. The expiration must be within the next 90 days.
• notifications - Specify up to 12 recipients of the service token in the notifications object. Set notifications.type as NOTIFICATION and enter the emails in notifications.emails.

Paramètres de connexion

• allowRemoteConnection - Setting allowRemoteConnection to true allows your user or customer to create connections from your port to destinations in different Metros. Setting to false limits connections to destinations in the same Metro as the port.
• bandwidthLimit - Use the bandwidthLimit parameter to set the maximum bandwidth for a connection created using this service token.

Sélection du port

• Spécifiez le port auquel vous accordez l'accès dans l'objet aSide.accessPointSelectors. Définir accessPointSelectors.type à COLO. Précisez le port dans port.uuid.
• Utilisez l'objet linkProtocol pour spécifier l'encapsulation et les détails VLAN du port.

Exemple de requête cURL:

curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'  
-H 'Content-Type: application/json'  
-H 'Authorization: Bearer <token>' 
-d '{
  "type": "VC_TOKEN",
  "expirationDateTime": "<token_expiration_date>",
  "connection": {
    "type": "EVPL_VC",
    "allowRemoteConnection": <boolean>,
    "bandwidthLimit": <bandwidth_value>,
    "aSide": {
      "accessPointSelectors": [
        {
          "type": "COLO",
          "port": {
            "uuid": "<port_uuid>"
          },
          "linkProtocol": {
            "type": "DOT1Q",
            "vlanTag": <vlan_id>
          }
        }
      ]
    }
  },
  "notifications": [
    {
      "type": "NOTIFICATION",
      "emails": [
        "<token_recipient_email>",
        "<token_recipient_email>"
      ]
    }
  ]
}'

remarque

Le point de terminaison /fabric/v4/serviceTokens prend en charge le paramètre de requête dryRun à des fins de test.

État du jeton de service

Une fois le jeton de service créé, vous pouvez vérifier son statut, notamment s'il a été utilisé par un utilisateur ou un client. Si le statut est « Inactif », le jeton n'a pas encore été utilisé. Si le statut est « Actif », le jeton a été utilisé.

Si le statut est « Expiré », le jeton de service a atteint sa date d'expiration sans avoir été utilisé par votre utilisateur ou client.

Portal

Pour vérifier l'état de votre jeton de service, connectez-vous au [Portail client et accédez à votre Inventaire des jetons de service.

API

Pour vérifier l'état de vos jetons de service, envoyez une requête GET au point de terminaison /fabric/v4/serviceTokens. La réponse contient la liste de vos jetons de service ainsi que leur état dans le champ state.

Exemple de requête cURL:

curl -X GET 'https://api.equinix.com/fabric/v4/serviceTokens'  
-H 'Authorization: Bearer <token>'

Vous trouverez plus d'informations sur la gestion des jetons de service sur la page Inventaire des jetons de service.