# Criando tokens de serviço A-Side A Um token de serviço é uma chave exclusiva do Equinix Fabric que concede autorização a um recurso de interconexão. Um token de serviço A-Side permite que um usuário ou cliente crie uma conexão de sua porta Fabric para outros destinos no Fabric. Ele permite o uso agregado da sua porta Fabric A-Side e elimina a necessidade de você, o provedor ou revendedor, entender ou estar ciente dos requisitos exclusivos por conexão. ![](https://docs.equinix.com/pt-BR/assets/images/create-a-side-connections-f573b4bc220a74be54ca4473915a3633.png) Crie um token de serviço A-Side para autorizar o uso de sua porta Equinix Fabric para permitir que seus usuários ou clientes se conectem a provedores de cloud, provedores de rede ou qualquer outro destino Equinix Fabric. Como proprietário da porta A-Side, você é cobrado pelas conexões virtuais provisionadas por seus usuários ou clientes que resgatam seus tokens A-Side. > **Observação** > > Se um token de serviço A-Side tiver sido compartilhado com você por um provedor, revendedor, operadora ou provedor de serviços, consulte [Resgate de um token A-Side](https://docs.equinix.com/pt-BR/fabric/service-tokens/redeem-a-side-service-token.md) . Para criar um token de serviço, você precisa ter: * Uma conta Equinix Fabric, com uma das seguintes [funções](https://docs.equinix.com/pt-BR/iam/roles-permissions/iam-roles-permission-reference.md): `Fabric Manager`, `Fabric Connection Manager`, `Fabric Service Provider`, `Fabric Service Profile Manager`, ou `End Customer Fabric Manager`. * Conceda permissões de acesso à porta para a qual deseja criar um token de serviço. * Se você estiver usando o API, autentique trocando seu ID de cliente e segredo de cliente por um token de acesso. Consulte [Autenticação API](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) para obter detalhes. ## Opções de tokens do lado A[​](#opções-de-tokens-do-lado-a "Link direto para Opções de tokens do lado A") **Configurações de conexão** : * VLANs - Dependendo do tipo de porta, você precisa fornecer as informações de encapsulamento e VLAN necessárias para fazer a conexão. Se você estiver usando uma porta dot1q, forneça um ID VLAN. Se você estiver usando uma porta QinQ, forneça a S-tag e a C-tag VLAN. * Largura de banda máxima - especifique a largura de banda máxima da conexão. O usuário ou cliente pode definir a velocidade da conexão até o limite de largura de banda. * Permitir conexões remotas - Especifique se deseja permitir conexões remotas à sua porta. Se você permitir conexões remotas, seu usuário ou cliente poderá criar conexões que terminam em um mercado estratégico diferente da sua porta. A não permissão de conexões remotas limita as conexões apenas a destinos do mesmo mercado estratégico da sua porta. **Configurações do token de serviço** : * Expiração - você deve definir uma data de expiração para o token de serviço. O cliente ou usuário deve usar o token para criar uma conexão antes da data de expiração. Se o token expirar, ele não poderá ser usado para criar uma conexão, e você precisará criar um novo token. * Destinatários do token de serviço - Envie o token de serviço para até 12 destinatários por e-mail. Um token é de uso único; apenas um dos destinatários pode usar o token. ## Criar um token de serviço[​](#criar-um-token-de-serviço "Link direto para Criar um token de serviço") * Portal * API Para criar um token de serviço do lado A: 1. Faça login no [Portal do Cliente](https://portal.equinix.com/fabric) > *Painel do Fabric* . 2. No menu *Tokens de serviço*, selecione **Criar token de serviço** . ![](https://docs.equinix.com/pt-BR/assets/images/create-service-token-drop-down-a304f07e49d3e840e2fa4bbc3c39fb11.png) **Tipo de token de serviço** 1. Na seção *Tipo de token de serviço* , selecione **Token de serviço A-Side** . 2. Na seção *Ativo A-Side*, *a porta* é selecionada automaticamente. ![](https://docs.equinix.com/pt-BR/assets/images/create-a-side-token-type-722fc7b8136958bea744117984dfd143.png) 3. Clique **e selecione Porta**, escolha uma porta na lista de portas elegíveis no projeto atual. Clique em **Selecionar porta**. ![](https://docs.equinix.com/pt-BR/assets/images/create-a-side-select-port-edb2e22c39d3ee50a854548655e73d20.png) Clique em **Avançar**. **Configurações de conexão** Em *Configurações de conexão* : 1. Insira as informações de VLAN para sua Porta. 2. Selecione a largura de banda máxima para conexões da sua Porta. 3. Para permitir conexões remotas, marque o BOX *Permitir conexões remotas* check. ![](https://docs.equinix.com/pt-BR/assets/images/create-a-side-connection-settings-154c21eefdbd81f1eadc47b2c7057820.png) **Configurações do token de serviço** Em *Configurações de token de serviço* : 1. Insira ou escolha uma data de expiração para o token de serviço. O tempo máximo de expiração é de 90 dias. ![](https://docs.equinix.com/pt-BR/assets/images/create-a-side-expiration-d201f7ded8c4a34adb146cf7543adc81.png) 2. Insira os endereços de e-mail dos usuários que receberão este token de serviço. Este token só pode ser usado uma única vez por qualquer um dos destinatários. ![](https://docs.equinix.com/pt-BR/assets/images/create-a-side-recipients-fc238c8b7b7897c476cd0aa30ba2539a.png) Clique em **Avançar**. **Revise** Consulte as informações do token de serviço nas seções *Tipo de token de serviço* , *Configurações de conexão* e *Configurações de token de serviço* . Se você precisar alterar as informações, clique em **Voltar**. Depois de criar um token de serviço do lado A e compartilhá-lo com seu usuário ou cliente, ele terá permissão total para criar uma conexão a partir da porta definida pelo token de serviço. Você, o criador do token A-Side e o proprietário da porta, são cobrados pela conexão feita pelo seu usuário ou cliente. Quando as informações do token de serviço estiverem corretas, clique em **Criar token de serviço** . ![](https://docs.equinix.com/pt-BR/assets/images/create-a-side-review-8c37f70ceaa964b65bc2b048a6da4148.png) Para criar um token de serviço A-Side, envie uma `POST` solicitação ao [`/fabric/v4/serviceTokens`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/service-tokens/createservicetoken.md)terminal. Informe as configurações do token de serviço, as configurações de conexão e os detalhes da porta no corpo da solicitação. **Configurações do token de serviço** * `expirationDateTime` - Especifique a data de expiração do token de serviço no formato de data e hora ISO 8601. A expiração deve ser dentro dos próximos 90 dias. * `notifications` - Especifique até 12 destinatários do token de serviço no `notifications`objeto. Defina `notifications.type` como `NOTIFICATION` e insira os e-mails em `notifications.emails`. **Configurações de conexão** * `allowRemoteConnection` - A configuração `allowRemoteConnection` para `true` permite que seu usuário ou cliente crie conexões de sua porta para destinos em diferentes mercados estratégicos. A configuração para `false` limita as conexões a destinos no mesmo mercado estratégico que a porta. * `bandwidthLimit` - Use o `bandwidthLimit` parâmetro para definir a largura de banda máxima para uma conexão criada usando este token de serviço. **Seleção de porta** * Especifique a porta à qual você está concedendo acesso no `aSide.accessPointSelectors`objeto. Definir `accessPointSelectors.type` como `COLO`. Especifique a porta em `port.uuid`. * Use o `linkProtocol` objeto para especificar os detalhes de encapsulamento e VLAN da porta. Exemplo de solicitação cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens' -H 'Content-Type: application/json' -H 'Authorization: Bearer ' -d '{ "type": "VC_TOKEN", "expirationDateTime": "", "connection": { "type": "EVPL_VC", "allowRemoteConnection": , "bandwidthLimit": , "aSide": { "accessPointSelectors": [ { "type": "COLO", "port": { "uuid": "" }, "linkProtocol": { "type": "DOT1Q", "vlanTag": } } ] } }, "notifications": [ { "type": "NOTIFICATION", "emails": [ "", "" ] } ] }' ``` > **Observação** > > O `/fabric/v4/serviceTokens` terminal aceita o [`dryRun`parâmetro de consulta](https://docs.equinix.com/pt-BR/equinix-api/testing/testing-in-production-dry-run.md) para fins de teste. ## Status do token de serviço[​](#status-do-token-de-serviço "Link direto para Status do token de serviço") Depois de criar um token de serviço, você pode verificar seu status, incluindo se ele foi resgatado pelo seu usuário ou cliente. Se o status for `Inactive`, o token de serviço ainda não foi resgatado. Se o status for `Active`, o token de serviço foi resgatado. Se o status for `Expired`, o token de serviço atingiu a data de expiração sem ser resgatado pelo usuário ou cliente. * Portal * API Para verificar o status do token de serviço, faça login no [Portal do Cliente](https://portal.equinix.com/fabric) e navegue até o [Inventário de token de serviço](https://docs.equinix.com/pt-BR/fabric/service-tokens/service-token-inventory.md) ![](https://docs.equinix.com/pt-BR/assets/images/create-a-side-inventory-ffd1e8fb00db4b9dfc7b80726bb1bb35.png) Para verificar o status de seus tokens de serviço, envie uma `GET` solicitação para o [`/fabric/v4/serviceTokens`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/service-tokens/getservicetokens.md) terminal. A resposta inclui uma lista de seus tokens de serviço junto com seus status no `state`campo. Exemplo de solicitação cURL: ``` curl -X GET 'https://api.equinix.com/fabric/v4/serviceTokens' -H 'Authorization: Bearer ' ``` Mais informações sobre o gerenciamento de tokens de serviço estão disponíveis na página[Inventário de tokens de serviço](https://docs.equinix.com/pt-BR/fabric/service-tokens/service-token-inventory.md).