Aサイド・サービス・トークンの作成

サービストークンとは、相互接続アセットへの権限を付与する一意のEquinix Fabricキーです。

A-サイド・サービス・トークンは、ユーザーまたは顧客がFabricポートからFabric上の他の接続先への接続を作成することを可能にします。これにより、A側Fabricポートの集約利用が可能になり、プロバイダや再販業者は、接続ごとに固有の要件を理解したり認識したりする必要がなくなります。

A側サービストークンを作成し、エクイニクスFabricポートの使用を許可することで、ユーザーや顧客がクラウドプロバイダーやネットワークプロバイダー、その他のエクイニクスFabric接続先に接続できるようになります。Aサイドポートの所有者であるお客様は、Aサイドトークンを利用するユーザーや顧客によってプロビジョニングされた仮想接続に対して課金されます。

注

プロバイダ、再販業者、通信事業者、サービスプロバイダからA-sideサービス・トークンを共有されている場合は、Redeeming an A-side Service-tokenを参照してください。

サービス・トークンを作成するには、以下のものが必要です：

• 次のいずれかのロールを持つEquinix Fabricアカウント。Fabric Manager、Fabric Connection Manager、Fabric Service Provider、、Fabric Service Profile Managerまたは。End Customer Fabric Manager
• サービス・トークンを作成するポートへのアクセス許可。
• APIを使用している場合は、アクセストークンのクライアントIDとクライアントシークレットを交換して認証する。詳細はAPI認証を参照。

Aサイド・トークン・オプション

接続設定 ：

• VLAN - ポートのタイプに応じて、接続に必要なカプセル化とVLAN情報を提供する必要があります。Dot1q ポートを使用している場合は、VLAN ID を指定します。QinQ ポートを使用している場合は、VLAN S タグと C タグを指定します。

• 最大帯域幅 - 接続の最大帯域幅を指定します。ユーザーまたは顧客は、帯域幅の上限まで接続速度を設定できます。

• Allow Remote Connections - ポートへのリモート接続を許可するかどうかを指定します。リモート接続を許可すると、ユーザーまたは顧客は、ポートとは異なるメトロで終端する接続を作成できます。リモート接続を許可しない場合、接続先はポート と同じメトロに限定されます。

サービス・トークンの設定 ：

• 有効期限 - サービス・トークンに有効期限を設定する必要があります。顧客またはユーザーは、有効期限内にトークンを使用して接続を作成する必要があります。トークンの有効期限が切れると、接続に使用できなくなるため、新しいトークンを作成する必要があります。

• サービス・トークンの受信者 - サービス・トークンを最大12人の受信者に電子メールで送信します。トークンは1回限り使用でき、受信者のうち1人だけがトークンを使用できます。

サービス・トークンの作成

Portal

A側サービス・トークンを作成する：

1. カスタマーポータル > _Fabric Dashboard_にサインインします。

2. _[サービストークン]_メニューから、[サービストークンの作成]を選択する。

サービス・トークン・タイプ

1. Service Token Type_セクションで、A-side Service Token を選択します。

2. A-side Asset_セクションで、_Port_が自動的に選択されます。

   

3. + Select Port をクリックし、現在のプロジェクトの対象ポートリストからポートを選択します。Select Port をクリックします。

   

次へ をクリックしてください。

接続設定

接続設定

1. ポートのVLAN情報を入力します。

2. ポートからの接続の最大帯域幅を選択します。

3. リモート接続を許可するには、Allow Remote Connections チェックボックスをオンにします。

サービス・トークンの設定

サービス・トークンの設定

1. サービス・トークンの有効期限を入力または選択します。最大有効期限は90日です。

   

2. このサービス・トークンを受け取るユーザーのメールアドレスを入力してください。このトークンはどの受信者も1回しか使用できません。

   

次へ をクリックしてください。

レビュー

サービストークンの_種類、_ 接続設定、_サービストークン設定の_各セクションでサービストークン情報を確認する。情報を変更する必要がある場合は、[戻る]をクリックする。

:::info重要 A側サービス・トークンを作成し、それをユーザーまたは顧客と共有すると、ユーザーはサービス・トークンで定義されたポートから接続を作成する完全な許可を得られます。A側トークンの作成者であり、ポートの所有者であるお客様は、ユーザーまたは顧客によって行われた接続に対して課金されます。 :::

サービス・トークンの情報が正しければ、Create Service Token をクリックします。

API

A サイドのサービス トークンを作成するには、/fabric/v4/serviceTokens エンドポイントに POST リクエストを送信します。リクエストの本文に、サービス トークンの設定、接続設定、およびポートの詳細をプロバイダとして指定します。

サービス・トークンの設定

• expirationDateTime-サービストークンの有効期限をISO 8601 datetime形式で指定する有効期限は今後90日以内であること。
• notifications-オブジェクト内のサービストークンの受信者を最大12人指定するnotificationsとしてNOTIFICATION設定notifications.typeし、に電子メールを入力する。notifications.emails

接続設定

• allowRemoteConnection-をtrue設定すると、allowRemoteConnectionユーザーまたは顧客は、ポートから異なるメトロの宛先への接続を作成できる。ポートと同じメトロ内の宛先への接続を制限する設定。false
• bandwidthLimit-このサービストークンを使用して作成された接続の最大帯域幅を設定するには'パラメータを使用するbandwidthLimit

ポート選択

• オブジェクト内でアクセスを許可するポートを指定するaSide.accessPointSelectorsとして設定accessPointSelectors.type``COLOでポートを指定する。port.uuid
• ポートのカプセル化と VLAN の詳細を指定するには、linkProtocol オブジェクトを使用します。

サンプル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>"
      ]
    }
  ]
}'

注

/fabric/v4/serviceTokensエンドポイントはテスト目的でクエリパラメータをサポートしている。dryRun

サービス・トークンのステータス

サービストークンを作成したら、ユーザーまたは顧客が利用したかどうかなど、そのステータスを確認できる。ステータスがの場合、Inactiveサービストークンはまだ引き換えられていない。ステータスがの場合、Activeサービストークンは引き換え済みである。

ステータスがの場合、Expiredサービストークンがユーザーまたは顧客によって引き換えられずに有効期限に達している。

Portal

サービストークンのステータスを確認するには、エクイニクススタマーポータル にサインインし、[Service Token Inventory] (service-token-inventory.md) にアクセスしてください。

API

サービス トークンの状態を確認するには、/fabric/v4/serviceTokens エンドポイントに GET リクエストを送信します。レスポンスには、サービストークンのリストと state フィールドのステータスが含まれます。

サンプルcURLリクエスト：

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

サービス・トークンの管理に関する詳細は、Service Token Inventory ページを参照してください。