# Conectando-se ao Fabric com um token de serviço Faça uma conexão de seus dispositivos Network Edge a destinos no Fabric resgatando um token de serviço Z-Side. Você pode receber um token de serviço Z-Side de um revendedor, operadora, provedor de serviços ou outro cliente da Equinix Fabric para que possa criar para sua infraestrutura ou serviço. Ao criar a conexão, você seleciona o dispositivo virtual e suas configurações de conexão, e o token de serviço fornece os detalhes da conexão e a configuração do outro lado da conexão. Cada conexão requer seu próprio token de serviço. Você pode criar um par de conexões a partir de seus dispositivos virtuais redundantes ou de cluster com dois tokens de serviço separados. > **Observação** > > Para permitir que alguém crie uma conexão COM seu dispositivo virtual Network Edge, você pode [criar e compartilhar um token de serviço Z-Side](https://docs.equinix.com/pt-BR/fabric/service-tokens/create-z-side-token.md) . ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") * Portal * API 1. Faça login no [Equinix Customer Portal](https://portal.equinix.com/) e navegue até o Painel do Network Edge. 2. Clique em **Criar Conexão**. ![](https://docs.equinix.com/pt-BR/assets/images/service-provider-create-connection-49f02d48309fc652e6b31fbd69a326fd.png) 1. Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para OAuth2. autenticação. Consulte [Autenticação API](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais. 2. Recupere as informações do seu dispositivo Network Edge usando os [`/ne/v1/devices`](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/getvirtualdevices)terminais ou[`/ne/v1/devices/{uuid}`](https://docs.equinix.com/pt-BR/api-catalog/network-edgev1/virtual-device/getvirtualdevicebyuuid). Se você estiver se conectando a partir de dispositivos redundantes, precisará do UUID do dispositivo primário ou secundário. Se você estiver se conectando a partir de um dispositivo de cluster, precisará do UUID de `node0` ou `node1`. Pode haver apenas uma conexão por token de serviço. As conexões adicionais com dispositivos redundantes ou de cluster exigem tokens de serviço adicionais. 3. Recupere seu token de serviço. * Se um terceiro compartilhou um token de serviço para que você possa se conectar à infraestrutura ou serviço dele, você precisará do UUID do token de serviço que ele compartilhou com você. * Se você estiver se conectando aos seus próprios ativos com um token de serviço que você ou outra pessoa em sua organização criou, poderá recuperar o UUID do token de serviço do [`/fabric/v4/serviceTokens`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/service-tokens/getservicetokens.md)terminal, juntamente com as configurações de conexão permitidas. ## Criando a conexão[​](#criando-a-conexão "Link direto para Criando a conexão") * Portal * API Na página *Criar uma conexão com::*: 1. Clique em **Inserir token de serviço** , no cartão *Conectar usando token de serviço* . ![](https://docs.equinix.com/pt-BR/assets/images/service-token-connections-menu-96ae3f5091bbcf89410c63c92be6c66a.png) 2. Insira seu token de serviço Z-Side. Verifique se os *detalhes do token de serviço* estão corretos e clique em **Resgatar token de serviço** . ![](https://docs.equinix.com/pt-BR/assets/images/service-token-redeem-344e66b23c8acb912cc900be97ceb66a.png) 1. Clique em **Avançar**. 2. No menu suspenso *Tipo de ativo de origem*, selecione **Dispositivo virtual** . 3. Na seção *Origem* , clique em **Dispositivo Virtual** . 4. Selecione o local e o tipo de dispositivo virtual. * Se você estiver se conectando a partir de um único dispositivo, a opção de conexão única será selecionada para você. * Se você estiver se conectando a partir de dispositivos redundantes ou de cluster, terá a opção de criar uma conexão redundante. Insira o token de serviço para a segunda conexão no campo *Destino redundante*. 5. Selecione o(s) dispositivo(s) virtual(s) e clique em **Avançar**. ![](https://docs.equinix.com/pt-BR/assets/images/service-token-virtual-device-fe4db02711276df460318a5122625160.png) 6. Na página *Informações de conexão*: * Insira um nome para a conexão. Para conexões redundantes, insira um nome para a conexão primária no campo *Informações da conexão primária* e um nome para a conexão secundária no campo *Informações da conexão* secundária. * Na seção *Seleção de interface*, escolha **selecionar automaticamente a próxima interface disponível no(s) meu(s) dispositivo(s)** ou **selecionarei uma interface**. * *(Opcional)* Insira o número do pedido de compra. * Selecione uma *Velocidade de Conexão* . As opções de velocidade de conexão são predefinidas pelo token de serviço. Para solicitar conexões redundantes, selecione uma velocidade de *conexão primária* e uma velocidade de *conexão secundária*. * Clique em **Avançar**. ![](https://docs.equinix.com/pt-BR/assets/images/service-token-connection-info-8c09f23678501108dafe7a21853c4e1e.png) 7. Na página *Revisão*, revise as informações em Visualização, Resumo da conexão e Visão geral de preços. Na seção *Notificações*, adicione os endereços de e-mail de todos os usuários que devem receber notificações sobre essa conexão. ![](https://docs.equinix.com/pt-BR/assets/images/service-token-review-41a501edf2fa8a66a48c64e247a04899.png) 8. Clique em **Enviar pedido**. Para criar uma conexão entre seu dispositivo virtual e outro local de rede no Fabric usando um token de serviço, envie uma `POST` solicitação ao [`/fabric/v4/connections`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/createconnection.md)terminal. Defina seu dispositivo Network Edge no `aSide` objeto, incluindo: * `accessPoint.type` as `VD` * `virtualDevice.type` como `EDGE` * `virtualDevice.uuid` Como UUID do seu dispositivo Forneça o UUID do token de serviço no `zSide`objeto. O token de serviço fornece todas as outras informações necessárias para estabelecer a conexão. Exemplo de solicitação 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": [ "", "" ] } ] }' ``` ## Monitoramento do status da conexão[​](#monitoramento-do-status-da-conexão "Link direto para Monitoramento do status da conexão") * Portal * API Você pode monitorar o status da sua nova conexão no [*Inventário de Conexões*](https://docs.equinix.com/pt-BR/fabric/managing-connections/fabric-new-connections-inventory.md) . Use o [`/fabric/v4/connections/{connectionId}`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/connections/getconnectionbyuuid.md)terminal API para monitorar o status da conexão.