アクセス・キーの管理

コンソールを使用したアクセスキーの管理

IBM Cloud コンソールを使用すると、 Workload Protection インスタンスのアクセスキーを表示、作成、無効化、有効化、および削除することができます。

コンソールを使用してアクセスキーを管理するには、以下の手順を実行してください

IBM Cloud コンソールで、 ナビゲーションメニュー アイコン ＞ [セキュリティ] ＞ [コンプライアンス] をクリックします。
Workload Protection インスタンスの名前をクリックしてください。
[アクション ] メニューから、[ キーの管理 ] を選択します。
ダッシュボードをクリックして、アクセスキーの表示、作成、無効化、有効化、または削除を行ってください。

また、管理者以外のユーザーにはアクセスキーを表示しないようにすることもできます。詳細については、「管理者以外のユーザー」をご覧ください。

CLI を使用してアクセスキーを取得する

CLI を使用して Workload Protection インスタンスのアクセスキーを取得するには、以下の手順を実行してください

IBM Cloud CLI をインストールします。
Workload Protection インスタンスが存在するリージョンにログインするには、次の ibmcloud login コマンドを実行して、xml-ph-0000@deepl.internalインスタンスが含まれるリージョンにログインします：
```
ibmcloud login
```
インスタンスが実行されているリソースグループを設定するには、 ibmcloud target コマンドを実行して、インスタンスが実行されているリソースグループを設定します：
```
ibmcloud target -g <resource_group>
```
ここで、 <resource_group> はリソースグループの名前です。デフォルトでは、default リソース・グループが設定されています。
次の ibmcloud resource service-instances コマンドを実行して、インスタンス名を取得します：
```
ibmcloud resource service-instances
```
インスタンスに関連付けられているAPIキーの名前を取得するには、 ibmcloud resource service-keys コマンドを実行して、インスタンスに関連付けられているAPIキーの名前を取得します：
```
ibmcloud resource service-keys --instance-name <instance_name> --output JSON
```
ここで、 <instance_name> は、前の手順で取得したインスタンスの名前です。

このコマンドの出力には、インスタンスのアクセスキーが格納された「 Sysdig Access Key 」フィールドが含まれます。

また、API やコンソールを使用して、アクセスキーの作成、削除、有効化、無効化を行うこともできます。手順を確認するには、APIの説明に切り替えるか、「コンソールを使用したアクセスキーの管理」に進んでください。

API を使用してアクセスキーを取得する

アクセスキーは、CLI またはコンソールを使用して取得できます。手順を確認するには、CLI または UI の説明に切り替えてください。また、API を使用して、利用可能なすべてのアクセスキーを取得することもできます。詳細については、「API を使用して利用可能なアクセスキーを確認する」を参照してください。

API を使用してアクセスキーを作成する

アクセス・キーが漏えいした場合や数日後にアクセス・キーを更新するポリシーがある場合は、新しいアクセス・キーを生成して古いキーを無効にすることができます。

Workload Protection インスタンスの新しいアクセス・キーを作成するには、以下のステップを実行します。

Workload Protection のUIからAPIトークンをコピーしてください。詳細については、「 Sysdig API トークンの取得」を参照してください。
エンドポイントに対して curl の POST リクエストを送信し、新しいアクセスキーを生成します：
```
curl -X POST -H 'Authorization: Bearer SYSDIG_API_TOKEN' -H 'IBMInstanceID: GUID' https://ENDPOINT/api/customer/accessKeys
```
ここで、
- ENDPOINT インスタンスが利用可能なリージョンの URL です。詳細については、「エンドポイント」を参照してください。
- SYSDIG_API_TOKEN これは、手順 1 で取得した API トークンです。
- GUID は、アクセス・キーに関連付けられているインスタンスの GUID です。
以下に例を示します。
```
curl -X POST -H 'Authorization: Bearer xxxxxxx' -H 'IBMInstanceID: 12345678-1234-1234-1234-123456789012' https://us-east.security-compliance-secure.cloud.ibm.com/api/customer/accessKeys
```
この出力では、生成されたアクセスキーがレスポンスに含まれます：
```
{
    "customerAccessKey": {
        "enabled": true,
        "accessKey": "12345678-1234-1234-1234-123456789012",
        "dateCreated": 1573852152224,
        "dateDisabled": null,
        "limit": null,
        "reservation": null,
        "teamId": null
    }
}
```
アクセスキーを使用してエージェントを設定できるようになりました。

API を使用してアクセスキーを無効にする

Workload Protection インスタンスの既存のアクセス・キーを無効にするには、以下のステップを実行します。

Workload Protection のUIからAPIトークンをコピーしてください。詳細については、「 Sysdig API トークンの取得」を参照してください。
アクセスキーを無効にするには、そのエンドポイントに対して curl の POST リクエストを送信してください：
```
curl -X POST -H 'Authorization: Bearer SYSDIG_API_TOKEN' -H 'IBMInstanceID: GUID' https://ENDPOINT/api/customer/accessKeys/ACCESS_KEY/disable
```
ここで、
- ENDPOINT インスタンスが利用可能なリージョンの URL です。
- SYSDIG_API_TOKEN これは、手順 1 で取得した API トークンです。
- ACCESS_KEY 無効にしたいアクセスキーです。
- GUID は、アクセス・キーに関連付けられているインスタンスの GUID です。
アクセスキーを無効にすると、そのアクセスキーで接続されているエージェントは、直ちにこの Workload Protection インスタンスへのメトリクスの送信がブロックされます。

以下に例を示します。
```
curl -X POST -H 'Authorization: Bearer xxxxxxx' -H 'IBMInstanceID: 12345678-1234-1234-1234-123456789012' https://us-east.security-compliance-secure.cloud.ibm.com/api/customer/accessKeys/b302311f-aa1c-4930-8726-59fb4ba0fe84/disable
```
この出力では、レスポンス内に障害者用アクセスキーが提供されます：
```
{
    "customerAccessKey": {
        "enabled": false,
        "accessKey": "12345678-1234-1234-1234-123456789012",
        "dateCreated": 1573852152224,
        "dateDisabled": 1683550789329,
        "limit": null,
        "reservation": null,
        "teamId": null
    }
}
```

API を使用してアクセスキーを有効にする

Workload Protection インスタンスの既存のアクセス・キーを有効にするには、以下のステップを実行します。

Workload Protection のUIからAPIトークンをコピーしてください。詳細については、「 Sysdig API トークンの取得」を参照してください。
アクセスキーを有効にするには、そのエンドポイントに対して curl の POST リクエストを送信してください：
```
curl -X POST -H 'Authorization: Bearer SYSDIG_API_TOKEN' -H 'IBMInstanceID: GUID' https://ENDPOINT/api/customer/accessKeys/ACCESS_KEY/enable
```
ここで、
- ENDPOINT インスタンスが利用可能なリージョンの URL です。
- SYSDIG_API_TOKEN これは、手順 1 で取得した API トークンです。
- ACCESS_KEY 有効にしたいアクセスキーです。
- GUID は、アクセス・キーに関連付けられているインスタンスの GUID です。

アクセスキーを有効にした後は、無効なアクセスキーで接続しているエージェントは終了してしまうため、エージェントを手動で再起動する必要があります。

API を使用して利用可能なアクセスキーを確認する

Workload Protection インスタンスのすべてのアクセス・キーを表示するには、以下のステップを実行します。

Workload Protection のUIからAPIトークンをコピーしてください。詳細については、「 Sysdig API トークンの取得」を参照してください。

アクセスキーを表示するには、リージョナルエンドポイントに対して curl の GET リクエストを送信します：

curl -X GET -H 'Authorization: Bearer SYSDIG_API_TOKEN' -H 'IBMInstanceID: GUID' https://ENDPOINT/api/customer/accessKeys

ここで、

ENDPOINT インスタンスが利用可能なリージョンの URL です。詳細については、「エンドポイント」を参照してください。
SYSDIG_API_TOKEN これは、手順 1 で取得した API トークンです。
GUID は、アクセス・キーに関連付けられているインスタンスの GUID です。

出力には、アクセスキーの一覧と、それらが有効になっているかどうかが表示されます：

{
    "customerAccessKeys": [
        {
            "enabled": true,
            "accessKey": "12345678-1234-1234-1234-123456789012",
            "dateCreated": 1541096409000,
            "dateDisabled": null,
            "limit": null,
            "reservation": null,
            "teamId": null
        },
        {
            "enabled": false,
            "accessKey": "87654321-1234-1234-1234-123456789012",
            "dateCreated": 1573849361000,
            "dateDisabled": 1573849367000,
            "limit": null,
            "reservation": null,
            "teamId": null
        }
    ]
}

API を使用してアクセスキーを削除する

Workload Protection インスタンスのアクセスキーを削除するには、以下の手順を実行してください

Workload Protection のUIからAPIトークンをコピーしてください。詳細については、「 Sysdig API トークンの取得」を参照してください。
アクセスキーを削除するには、リージョナルエンドポイントに対して curl DELETE リクエストを実行します：
```
curl -X DELETE -H 'Authorization: Bearer SYSDIG_API_TOKEN' -H 'IBMInstanceID: GUID' https://ENDPOINT/api/customer/accessKeys/ACCESS_KEY
```
ここで、
- ENDPOINT インスタンスが利用可能なリージョンの URL です。
- SYSDIG_API_TOKEN これは、手順 1 で取得した API トークンです。
- GUID は、アクセス・キーに関連付けられているインスタンスの GUID です。
- ACCESS_KEYは、削除するアクセス・キーです。すべてのアクセス・キーのリストの表示を使用して、アクセス・キー値を取得できます。