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 do lado A permite que um usuário ou cliente crie uma conexão da sua porta Fabric para outros destinos na Fabric . Ele possibilita o uso agregado da sua porta Fabric do lado A e elimina a necessidade de você, provedor ou revendedor, entender ou estar ciente dos requisitos específicos de cada conexão.

Crie um token de serviço A-side para autorizar o uso da sua porta Equinix Fabric, permitindo que seus usuários ou clientes se conectar a provedores de cloud, provedores de rede ou qualquer outro destino Equinix Fabric . Como proprietário da porta A-side, você será cobrado pelas conexões virtuais provisionadas por seus usuários ou clientes que resgatarem seus tokens A-side.

Notas

Se um token de serviço do lado A foi compartilhado com você por um provedor, revendedor, operadora ou prestador de serviços, consulte Resgatando um token do lado A.

Para criar um token de serviço, você precisa ter:

• Uma conta do Equinix Fabric, com uma das seguintes funções: 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, faça a autenticação trocando seu ID de cliente e segredo de cliente por um token de acesso. Consulte Autenticação do API para obter detalhes.

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 estabelecer a conexão. Se você usando uma porta Dot1q, forneça um ID de VLAN . Se você usando uma porta QinQ, forneça as tags S e C da VLAN .

• Largura de banda máxima - Especifique a largura de banda máxima da conexão. Seu usuário ou cliente poderá 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 terminem em uma área metropolitana diferente da sua porta. Não permitir conexões remotas limita as conexões apenas a destinos na mesma área metropolitana que a sua porta.

Configurações do Token de Serviço:

• Validade - Você deve definir uma data de validade para o token de serviço. Seu cliente ou usuário deve usar o token para criar uma conexão antes da data de validade. Se o token expirar, ele não poderá ser usado para criar uma conexão e você terá que 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. O token é de uso único; apenas um dos destinatários poderá utilizá-lo.

Criar um token de serviço

Portal

Para criar um token de serviço do lado A:

1. Faça login no Portal do Cliente > Painel de Controle do Fabric.

2. No menu Tokens de serviço , selecione Criar token de serviço .

Tipo de Token de Serviço

1. Na seção Tipo de Token de Serviço, selecione AToken de serviço do lado.

2. Na seção Ativo do lado A, Porta é selecionada automaticamente.

   

3. Clique em + Selecionar Porto, escolha um porto da lista de portos elegíveis no projeto atual. Clique em Selecionar Porto.

   

Clique em Próximo.

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 a caixa de seleção Permitir conexões remotas.

Configurações do Token de Serviço

Em Configurações do Token de Serviço:

1. Insira ou selecione uma data de expiração para o token de serviço. O prazo máximo de expiração é de 90 dias.

   

2. Insira os endereços e-mail dos usuários que receberão este token de serviço. Este token só pode ser usado uma vez por cada destinatário.

   

Clique em Próximo.

Análise

Revise 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.

Após você 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 do lado A e proprietário da Porta, será cobrado 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.

API

Para criar um token de serviço do lado A, envie uma solicitação POST para o endpoint /fabric/v4/serviceTokens. Forneça as configurações do seu 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 notificationsobjeto. Defina notifications.type como NOTIFICATION e insira os e-mails no notifications.emails.

Configurações de conexão

• allowRemoteConnection - A configuração allowRemoteConnection para true permite que seu usuário ou cliente crie conexões do seu porto para destinos em diferentes Metrôs. A configuração para false limita as conexões a destinos no mesmo metrô 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 Porto

• Especifique a qual porta você está concedendo acesso no aSide.accessPointSelectorsobjeto. Definir accessPointSelectors.type como COLO. Especifique a porta em port.uuid.
• Utilize o objeto linkProtocol 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 <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>"
      ]
    }
  ]
}'

Notas

O /fabric/v4/serviceTokens endpoint suporta o dryRunparâmetro de consulta para fins de teste.

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 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 sua data de expiração sem ser resgatado pelo usuário ou cliente.

Portal

Para verificar o status do seu token de serviço, faça login no Portal do Cliente e navegue até o seu Inventário de Tokens de Serviço

API

Para verificar o status dos seus tokens de serviço, envie uma solicitação GET para o endpoint /fabric/v4/serviceTokens. A resposta inclui uma lista dos seus tokens de serviço juntamente com seus respectivos status no campo state.

Exemplo de solicitação cURL:

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

Mais informações sobre o gerenciamento de tokens de serviço estão disponíveis na página Service Token Inventory.