認証にサービスIDを使用して、取り込み用のAPIキーを生成する

サービスIDのAPIキーを使用して、ロギング・エージェントでログを送信することができます。

個々のユーザーIDのAPIキーは、本番環境以外では使用しないでください。 APIキーを作成したユーザーが IBM Cloud の認可ユーザーでなくなった場合、そのユーザーに関連付けられた個々のユーザーIDのAPIキーは認可されなくなり、取り込みが停止される。 本番環境では、 Service ID APIキー または Trusted Profilesを 使用して設定する必要があります。

APIキーは、IBM Cloud Logs取り込みエンドポイントへの安全なWebソケットを開き、ロギング・エージェントを認証するために使用される。

APIキーは、特定のサービスIDとして認証するために使用され、その特定のサービスIDに関連付けられたアクセスが付与される。 詳しくは、『サービス ID の API キーの管理』を参照してください。

ポリシーを付与するユーザーが「Sender ロール権限を持っていることを確認してください。

APIキーを生成する前に、サービスIDに'Sender ロールを付与してください。

CLIを使用してAPIキーを生成する

CLIを使用してサービスIDのAPIキーを生成するには、以下の手順を実行します：

  1. IBM Cloudアカウントにログインします。

    ユーザー ID とパスワードを使用してログインすると、IBM Cloud ダッシュボードが開きます。

  2. IAMポリシーとAPIキーの認証情報に使用するサービスIDを作成する。

    サービスIDには、後でサービスIDを検索するのに役立つ説明を必ず付けてください。

    ibmcloud iam service-id-create logs-svc-id --description "Service ID for IBM Cloud Logs"

  3. サービスIDに、ログ送信へのアクセスを許可するIAMポリシーを追加する。

    ibmcloud iam service-policy-create <SERVICE_ID> --service-name logs --roles Sender

  4. サービス ID の API キーを作成します。

    必ず、後でキーを思い出せるように説明を付けてください。 API キーをセキュアな場所に保存します。 API キーを再度取得することはできません。 出力をローカル・マシンのファイルにエクスポートしたい場合は、 --file <path>/<file_name> オプションを指定します。

    ibmcloud iam service-api-key-create logs-ingestion-key <SERVICE_ID> --description "API key for service ID <SERVICE_ID> with permissions to send logs to the IBM Cloud Logs service"