# Connexion à la Fabric avec un jeton de service Établissez une connexion entre vos appareils Network Edge et des destinations sur Fabric en échangeant un jeton de service Z-Side. Vous pouvez recevoir un jeton de service Z-Side d’un revendeur, d’un opérateur, d’un fournisseur de services ou d’un autre client Equinix Fabric afin que vous puissiez le créer sur son infrastructure ou son service. Lors de la création de la connexion, vous sélectionnez le dispositif virtuel et ses paramètres de connexion, et le jeton de service fournit les détails de connexion et la configuration de l'autre côté de la connexion. Chaque connexion nécessite son propre jeton de service. Vous pouvez créer une paire de connexions à partir de vos dispositifs virtuels redondants ou de cluster avec deux jetons de service distincts. > **Note** > > Si vous souhaitez autoriser quelqu'un à créer une connexion À votre appareil virtuel Network Edge, vous pouvez [créer et partager un jeton de service Z-Side](https://docs.equinix.com/fr/fabric/service-tokens/create-z-side-token.md) . ## Conditions préalables[​](#conditions-préalables "Lien direct vers Conditions préalables") * Portal * API 1. Connectez-vous à [Equinix Customer Portal](https://portal.equinix.com/) et accédez au tableau de bord Network Edge. 2. Cliquez sur **créer une connexion**. ![](https://docs.equinix.com/fr/assets/images/service-provider-create-connection-49f02d48309fc652e6b31fbd69a326fd.png) 1. 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](https://docs.equinix.com/fr/equinix-api/api-authentication.md). 2. Récupérez les informations de votre terminal Network Edge à l'aide des [`/ne/v1/devices`](https://docs.equinix.com/fr/api-catalog/network-edgev1/virtual-device/getvirtualdevices)terminaux ou[`/ne/v1/devices/{uuid}`](https://docs.equinix.com/fr/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid). Si vous vous connectez à partir de dispositifs redondants, vous avez besoin de l'UUID du dispositif principal ou secondaire. Si vous vous connectez à partir d'un dispositif de cluster, vous avez besoin de l'UUID de `node0` ou `node1`. Il ne peut y avoir qu'une seule connexion par jeton de service. Des connexions supplémentaires à des dispositifs redondants ou de cluster nécessitent des jetons de service supplémentaires. 3. Récupérez votre jeton de service. * Si un tiers a partagé un jeton de service afin que vous puissiez vous connecter à son infrastructure ou à son service, vous avez besoin de l'UUID du jeton de service qu'il a partagé avec vous. * Si vous vous connectez à vos propres équipements avec un jeton de service que vous ou une autre personne de votre organisation avez créé, vous pouvez récupérer l'UUID du jeton de service à partir du [`/fabric/v4/serviceTokens`](https://docs.equinix.com/fr/api-catalog/fabricv4/service-tokens/getservicetokens.md) point de terminaison, ainsi que les paramètres de connexion autorisés. ## Créer la connexion[​](#créer-la-connexion "Lien direct vers Créer la connexion") * Portal * API Sur la page *créer une connexion à :* 1. Sur la carte *se connecter à l'aide d'un jeton de service* , cliquez sur **saisir** *un jeton de service* . ![](https://docs.equinix.com/fr/assets/images/service-token-connections-menu-96ae3f5091bbcf89410c63c92be6c66a.png) 2. Saisissez votre jeton de service Z-Side. Vérifiez que les *détails du jeton de service* sont corrects et cliquez sur **utiliser le jeton de service** . ![](https://docs.equinix.com/fr/assets/images/service-token-redeem-344e66b23c8acb912cc900be97ceb66a.png) 1. Cliquez sur **suivant**. 2. Dans la liste déroulante *type d’équipement d’origine*, sélectionnez **dispositif virtuel** . 3. Dans la section *origine*, cliquez sur **périphérique virtuel** . 4. Sélectionnez l'emplacement et le type de dispositif virtuel. * Si vous vous connectez à partir d'un seul appareil, l'option de connexion unique est sélectionnée pour vous. * Si vous vous connectez à partir de périphériques redondants ou de cluster, vous avez la possibilité de créer une connexion redondante. Dans le champ *destination redondante*, saisissez le jeton de service pour la deuxième connexion. 5. Sélectionnez le(s) dispositif(s) virtuel(s) et cliquez sur **suivant**. ![](https://docs.equinix.com/fr/assets/images/service-token-virtual-device-fe4db02711276df460318a5122625160.png) 6. Sur la page *informations de connexion* : * Entrez un nom de connexion. Pour les connexions redondantes, saisissez un nom pour la connexion principale dans le champ *informations sur la connexion principale* et un nom pour la connexion secondaire dans le champ *informations sur la connexion secondaire*. * Dans la section *sélection de l'interface* , choisissez de **sélectionner automatiquement l'interface disponible suivante sur mon(mes) appareil(s)** ou **je vais sélectionner une interface**. * *(Facultatif)* saisissez le numéro du bon de commande. * Sélectionnez une *vitesse de connexion* . Les options de vitesse de connexion sont prédéfinies par le jeton de service. Si vous commandez des connexions redondantes, sélectionnez à la fois une vitesse *de connexion principale* et une vitesse *de connexion secondaire*. * Cliquez sur **suivant**. ![](https://docs.equinix.com/fr/assets/images/service-token-connection-info-8c09f23678501108dafe7a21853c4e1e.png) 7. Sur la page *vérifier*, vérifiez les informations des sections Aperçu, Résumé de la connexion et Aperçu des tarifs. Dans la section *notifications*, ajoutez les adresses e-mail de tous les utilisateurs devant recevoir des notifications concernant cette connexion. ![](https://docs.equinix.com/fr/assets/images/service-token-review-41a501edf2fa8a66a48c64e247a04899.png) 8. Cliquez sur **Envoyer la commande**. Pour créer une connexion entre votre appareil virtuel et un autre emplacement réseau sur Fabric à l’aide d’un jeton de service, envoyez `POST`une demande au [`/fabric/v4/connections`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/createconnection.md)point final. Définissez votre dispositif Network Edge dans l'`aSide`objet, y compris : * `accessPoint.type` as `VD` * `virtualDevice.type` as `EDGE` * `virtualDevice.uuid` Comme UUID de votre appareil Indiquez votre UUID de jeton de service dans l'`zSide`objet. Le jeton de service fournit toutes les autres informations nécessaires pour établir la connexion. Exemple de requête cURL : ``` curl -X POST 'https://api.equinix.com/fabric/v4/connections' \ -H 'content-type: application/json' \ -H 'authorization: Bearer ' \ -d '{ "type": "EVPL_VC", "name": "", "bandwidth": , "aSide": { "accessPoint": { "type": "VD", "virtualDevice": { "type": "EDGE", "uuid": "" }, } }, "zSide": { "serviceToken": { "uuid": "" } }, "notifications": [ { "type": "ALL", "emails": [ "", "" ] } ] }' ``` ## Contrôle de l'état de la connexion[​](#contrôle-de-létat-de-la-connexion "Lien direct vers Contrôle de l'état de la connexion") * Portal * API Vous pouvez surveiller l'état de votre nouvelle connexion dans votre [*inventaire des connexions*](https://docs.equinix.com/fr/fabric/managing-connections/fabric-new-connections-inventory.md) . Utilisez le [`/fabric/v4/connections/{connectionId}`](https://docs.equinix.com/fr/api-catalog/fabricv4/connections/getconnectionbyuuid.md)point de terminaison API pour surveiller l'état de la connexion.