Création de jetons de service côté Z
Un jeton de service Z-Side est une clé unique qui permet à un autre client sur Equinix Fabric d'établir une connexion avec vous.
Vous pouvez créer des jetons Z-Side pour les types d’équipement suivants :
- Ports Fabric (types EVPL et EPL)
- Dispositifs virtuels Network Edge
- Réseaux multipoint : E-LAN, E-Tree et E-Access.
Une fois qu'un jeton de service Z-Side est créé et partagé avec un autre client, il peut utiliser le jeton pour créer une connexion avec votre équipement prédéfini comme destination.

Le client qui utilise le jeton Z-Side (le propriétaire de l’équipement A-Side d’origine) est facturé pour la connexion virtuelle une fois qu’il l’a créée. Un jeton de service Z-Side peut également être utilisé pour permettre à un autre utilisateur de votre propre organisation qui possède des actifs dans un autre projet de se connecter à un actif de votre projet.
Pour plus d'informations sur l'utilisation d'un jeton de service Z-Side, consultez la rubrique utilisation d'un jeton de service Z-Side .
Conditions préalables
Avant de créer un jeton de service, vous devez disposer des éléments suivants :
- Un compte du Portail clients.
- Un port, un dispositif virtuel ou un réseau multipoint existant.
- Permissions d'accès à un actif pour lequel vous souhaitez créer un jeton de service.
- Portal
- API
-
Connectez-vous au Portail client et accédez au tableau de bord Fabric .
-
Dans le menu jetons de service , sélectionnez créer un jeton de service .

-
Dans la section type de jeton de service , sélectionnez jeton de service Z-Side .

Sélectionnez le type d’équipement pour lequel vous souhaitez créer le jeton Z-Side : Port, dispositif virtuel ou réseau multipoint .
-
Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Pour savoir comment appeler OAuth API pour valider et authentifier vos identifiants, reportez-vous à authentification API.
-
Déterminez les informations relatives à vos équipements Z-Side.
-
Si vous utilisez un port, envoyez
GETune demande au/fabric/v4/portspoint final. Vous avez besoin du(s) UUID(s) de port, du type de port et du type de protocole de liaison (DOT1Q ou QINQ). -
Si vous utilisez un appareil virtuel, envoyez
GETune demande au/ne/v1/devicespoint final. Vous avez besoin du ou des UUID de l'appareil. Envoyer uneGETdemande au/ne/v1/devices/{device_id}terminal pour obtenir les détails d'un appareil. Vous pouvez choisir n'importe quelle interface disponible sur l'appareil pour votre connexion. Si vous n'en spécifiez pas, la connexion est automatiquement attribuée à la prochaine interface disponible. -
Si vous utilisez un réseau multipoint, envoyez une
GETdemande au/fabric/v4/networks/{networkId}terminal. Vous avez besoin du type et de l'UUID du réseau.
-
Créez un jeton de service pour un port
- Portal
- API
-
Dans la liste déroulante d’équipement Z-Side, sélectionnez Port.
-
Cliquez sur + sélectionner un port et choisissez le port spécifique pour le jeton de service dans la liste. Cliquez sur sélectionner un port.

-
Cliquez sur suivant.
-
Dans Paramètres de connexion :
- Saisissez le(s) identifiant(s) VLAN(s) de la connexion sur votre équipement Z-Side.
- Sélectionnez les largeurs de bande à mettre à la disposition de l'utilisateur de jeton. Cliquez sur Ajouter une autre bande passante pour créer une option de bande passante personnalisée.
- Choisissez d'autoriser ou non les connexions distantes. Cochez l’BOX autoriser les connexions distantes pour permettre aux utilisateurs de jetons de se connecter depuis une zone métropolitaine différente de l’emplacement de l’équipement Z-Side.

-
Dans Paramètres du jeton de service :
- Saisissez une date d'expiration pour le jeton de service. Le jeton doit être échangé avant cette date ou il expire. La période maximale est de 90 jours.
- Saisissez les adresses e-mail des utilisateurs autorisés à utiliser le jeton de service. Vous pouvez saisir jusqu'à 12 destinataires. Le jeton ne peut être utilisé qu'une seule fois par l'un des destinataires.

-
Cliquez sur suivant.
-
Sur la page vérifier, vérifiez les informations dans les panneaux type de jeton de service et Paramètres de jeton de service.

Lorsque vous êtes prêt, cliquez sur créer un jeton de service .
Pour créer un jeton de service Z-Side pour un port, envoyez POSTune demande au /fabric/v4/serviceTokenspoint final. Indiquez vos paramètres de connexion, les détails du port et les paramètres du jeton de service dans le corps de la demande.
-
Dans l'
connectionobjet, spécifiez :- Type de connexion basé sur le port sous-jacent :
EVPL_VCouEPL_VC. - Indique si ce jeton peut être utilisé pour créer des connexions distantes.
- Bande passante autorisée pour la connexion.
- Indique si ce jeton autorise l'utilisation de la bande passante personnalisée pour la connexion.
- Type de connexion basé sur le port sous-jacent :
-
Dans l'
zSideobjet, spécifiez :- L'
typeASCOLO. - UUID du port.
- Le type de protocole de liaison du port et les informations VLAN appropriées.
- L'
-
Utilisez le
expirationDateTimechamp pour spécifier la date et l'heure d'expiration du jeton au format ISO 8601. -
Dans l'
notificationsobjet, spécifiez les adresses e-mail des destinataires des jetons.
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",
"name": "<service_token_name>",
"description": "<service_token_description>",
"connection": {
"type": "EVPL_VC",
"allowRemoteConnection": <boolean>,
"allowCustomBandwidth": <boolean>,
"supportedBandwidths": [
<bandwidth_speed>,
<bandwidth_speed>,
<bandwidth_speed>
],
"zSide": {
"accessPointSelectors": [
{
"type": "COLO",
"port": {
"uuid": "<port_uuid>"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": "<vlan_ID>"
}
}
]
}
},
"expirationDateTime": "<expiration_date>",
"notifications": [
{
"type": "NOTIFICATION",
"emails": [
"<email_address>"
]
}
]
}'
Créez un jeton de service pour un dispositif virtuel
- Portal
- API
-
Dans la liste déroulante des ressources Z-Side, sélectionnez dispositif virtuel .
-
Choisissez un type de dispositif virtuel :
- Single Device - Appareils virtuels à instance unique.
- Dispositifs redondants : paire de dispositifs virtuels redondants. Important : Pour créer des connexions redondantes à des dispositifs redondants, vous devez créer un jeton de service distinct pour chaque dispositif de la paire de redondance.
- Clusters - Dispositifs virtuels en cluster.
-
Cliquez sur + sélectionner un dispositif virtuel et sélectionnez une instance de dispositif virtuel dans la liste. Cliquez sur sélectionner un périphérique virtuel .

-
Cliquez sur suivant.
-
Dans Paramètres de connexion :
- Configurez l'interface à utiliser pour la connexion. Choisissez si vous souhaitez utiliser la prochaine interface disponible ou choisir une interface spécifique.
- Sélectionnez les largeurs de bande à mettre à la disposition de l'utilisateur de jeton. Cliquez sur Ajouter une autre bande passante pour créer une option de bande passante personnalisée.
- Choisissez d'autoriser ou non les connexions distantes. Cochez l’BOX autoriser les connexions distantes pour permettre aux utilisateurs de jetons de se connecter depuis une zone métropolitaine différente de l’emplacement de l’équipement Z-Side.

-
Dans Paramètres du jeton de service :
- Saisissez une date d'expiration pour le jeton de service. Le jeton doit être échangé avant cette date ou il expire. La période maximale est de 90 jours.
- Saisissez les adresses e-mail des utilisateurs autorisés à utiliser le jeton de service. Vous pouvez saisir jusqu'à 12 destinataires. Le jeton ne peut être utilisé qu'une seule fois par l'un des destinataires.

-
Cliquez sur suivant.
-
Sur la page vérifier, vérifiez les informations dans les panneaux type de jeton de service et Paramètres de jeton de service.

Lorsque vous êtes prêt, cliquez sur créer un jeton de service .
Pour créer un jeton de service Z-Side pour un dispositif virtuel, envoyez POSTune demande au /fabric/v4/serviceTokenspoint final. Dans le corps de la demande, indiquez vos paramètres de connexion, les détails du dispositif virtuel et les paramètres du jeton de service.
-
Dans l'
connectionobjet, spécifiez :- Indique si ce jeton peut être utilisé pour créer des connexions distantes.
- Bande passante autorisée pour la connexion.
- Indique si ce jeton autorise l'utilisation de la bande passante personnalisée pour la connexion.
-
Dans l'
zSideobjet, spécifiez :- L'
typeASVD. - UUID de vos appareils virtuels.
- Interface à utiliser pour la connexion du jeton de service. Si l'
interfaceobjet est omis, la prochaine interface disponible sur l'appareil est utilisée pour la connexion.
- L'
-
Utilisez le
expirationDateTimechamp pour spécifier la date et l'heure d'expiration du jeton au format ISO 8601. -
Dans l'
notificationsobjet, spécifiez les adresses e-mail des destinataires des jetons.
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",
"name": "<service_token_name>",
"description": "<service_token_description>",
"connection": {
"type": "EVPL_VC",
"allowRemoteConnection": <boolean>,
"allowCustomBandwidth": <boolean>,
"supportedBandwidths": [
<bandwidth_speed>,
<bandwidth_speed>,
<bandwidth_speed>
],
"zSide": {
"accessPointSelectors": [
{
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "<virtual_device_uuid>"
},
"interface": {
"type": "NETWORK",
"id": <interface_id>
}
}
]
}
},
"expirationDateTime": "<expiration_date>",
"notifications": [
{
"type": "NOTIFICATION",
"emails": [
"<email_address>"
]
}
]
}'
Créez un jeton de service pour un réseau multipoint
- Portal
- API
-
Dans la liste déroulante des ressources Z-Side, sélectionnez réseau multipoint .
-
Cliquez sur + sélectionner un réseau et sélectionnez le réseau multipoint dans la liste. Cliquez sur sélectionner un réseau.

-
Cliquez sur suivant.
-
Dans Paramètres de connexion :
- Par défaut, les connexions créées à partir de jetons de service E-Tree seront Leaf. En tant que propriétaire du réseau, vous pouvez définir le rôle de connexion sur Root une fois que le jeton de service est utilisé et que la connexion a été provisionnée.
- Sélectionnez les largeurs de bande à mettre à la disposition de l'utilisateur de jeton. Cliquez sur Ajouter une autre bande passante pour créer une option de bande passante personnalisée.

-
Dans Paramètres du jeton de service :
- Saisissez une date d'expiration pour le jeton de service. Le jeton doit être échangé avant cette date ou il expire. La période maximale est de 90 jours.
- Saisissez les adresses e-mail des utilisateurs autorisés à utiliser le jeton de service. Vous pouvez saisir jusqu'à 12 destinataires. Le jeton ne peut être utilisé qu'une seule fois par l'un des destinataires.

-
Cliquez sur suivant.
-
Sur la page vérifier, vérifiez les informations dans les panneaux type de jeton de service et Paramètres de jeton de service.

Lorsque vous êtes prêt, cliquez sur créer un jeton de service .
Pour créer un jeton de service Z-Side pour un réseau multipoint, envoyez POSTune demande au /fabric/v4/serviceTokenspoint final. Dans le corps de la demande, indiquez vos paramètres de connexion, les détails réseau et les paramètres de jetons de service.
-
Dans l'
connectionobjet, spécifiez :- Le type de connexion est
EVPLAN_VC, ,EPLAN_VCouEVPTREE_VCEPTREE_VCen fonction de votre configuration réseau. - Indique si ce jeton peut être utilisé pour créer des connexions distantes.
- Bande passante autorisée pour la connexion.
- Indique si ce jeton autorise l'utilisation de la bande passante personnalisée pour la connexion.
- Le type de connexion est
-
Dans l'
zSideobjet :- Spécifiez le
typecommeNETWORK. - Indiquez le type de réseau sous la forme
EVPLAN,EPLAN, ,EVPTREEouEPTREE. - Indiquez l'UUID de votre réseau.
- Spécifiez le
-
Utilisez le
expirationDateTimechamp pour spécifier la date et l'heure d'expiration du jeton au format ISO 8601. -
Dans l'
notificationsobjet, spécifiez les adresses e-mail des destinataires des jetons.
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",
"name": "<service_token_name>",
"description": "<service_token_description>",
"connection": {
"type": "EVPLAN_VC",
"allowRemoteConnection": <boolean>,
"supportedBandwidths": [
<bandwidth_speed>,
<bandwidth_speed>,
<bandwidth_speed>
],
"zSide": {
"accessPointSelectors": [
{
"type": "NETWORK",
"network": {
"type": "EVPLAN",
"uuid": "<network_uuid>"
}
}
]
}
},
"expirationDateTime": "<token_expiration_date>",
"notifications": [
{
"type": "NOTIFICATION",
"emails": [
"<email_address>"
]
}
]
}'
Statut du jeton de service
Une fois que vous avez créé un jeton de service, vous pouvez vérifier son statut, y compris s'il a été échangé par l'autre client. Si le statut est Inactive, le jeton de service n'a pas encore été utilisé. Si le statut est Active, le jeton de service a été échangé.
Le créateur de la connexion utilisant un jeton Z-Side est facturé pour la connexion.
Si le statut est Expired, le jeton de service a atteint sa date d'expiration sans avoir été échangé.
- Portal
- API
Pour vérifier l'état de votre jeton de service, connectez-vous au Portail client et accédez à votre inventaire de jetons de service

Pour vérifier l'état de vos jetons de service, envoyez une GET demande au /fabric/v4/serviceTokenspoint de terminaison. La réponse inclut une liste de vos jetons de service ainsi que leur statut sur statele terrain.
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 pageinventaire des jetons de service.