OAuth2 Client Authエクステンション

はじめに

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

1. Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

   • インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

   • インストーラ・スクリプトを使用して Collector for Windows をインストールします。

   • Helmを使用してCollector for Kubernetesをインストールする

2. 次のセクションで説明するように、エクステンションを設定します。

3. Collector を再起動します。

サンプル構成

コンポーネントをアクティブにするには、設定ファイルのextensions セクションに oauth2client を追加します：

extensions:
  oauth2client:

設定を完了するには、設定ファイルの service セクションに拡張子を含めます：

service:
  extensions: [oauth2client]

コンフィギュレーション設定

エクステンションの設定には以下の設定が必要です：

• token_urlします。リソースサーバーのトークンエンドポイント URL。

• client_idします。クライアントに発行されたクライアント識別子。

• client_id_fileします。クライアントに発行されたクライアント識別子を取得するためのファイルパス。エクステンションはこのファイルを読み込み、新しいトークンを発行する必要があるときにクライアント ID を更新します。

  • このパラメータを使用すると、トークンをローテーションする必要がある場合などに、ファイルの内容を修正することでクライアントの認証情報を動的に変更することができます。

  • この設定は client_id よりも優先されます。

• client_secretします。識別子に関連付けられたシークレット文字列。

• client_secret_fileします。識別子に関連付けられたシークレット文字列を取得するためのファイルパス。エクステンションはこのファイルを読み込み、新しいトークンを発行する必要があるときにクライアントシークレットを更新します。

  • このパラメータにより、例えばトークンをローテーションする必要がある場合に、ファイルの内容を修正することでクライアントの認証情報を動的に変更することができます。

  • この設定は client_secret よりも優先されます。

• endpoint_paramsします。トークンのエンドポイントに送信される追加パラメータ。

• scopesします。オプション。クライアントに関連付けられた要求されたアクセス許可。

• timeoutします。オプション。認証サーバーがトークンを取得するための基礎となるクライアントのタイムアウトを、初期と更新中の両方に指定します。

  • 無効の場合、クライアントにタイムアウトはありません。

クライアント側 TLS 設定に関する情報は「TLS を設定する」を参照してください。

設定例

これはエクステンションの設定例です：

extensions:
  oauth2client:
    client_id: someclientid
    client_secret: someclientsecret
    endpoint_params:
      audience: someaudience
    token_url: https://example.com/oauth2/default/v1/token
    scopes: ["api.metrics"]
    # tls settings for the token client
    tls:
      insecure: true
      ca_file: /var/lib/mycert.pem
      cert_file: certfile
      key_file: keyfile
    # timeout for the token client
    timeout: 2s

receivers:
  hostmetrics:
    scrapers:
      memory:
  otlp:
    protocols:
      grpc:

exporters:
  otlphttp/withauth:
    endpoint: http://localhost:9000
    auth:
      authenticator: oauth2client

  otlp/withauth:
    endpoint: 0.0.0.0:5000
    tls:
      ca_file: /tmp/certs/ca.pem
    auth:
      authenticator: oauth2client

service:
  extensions: [oauth2client]
  pipelines:
    metrics:
      receivers: [hostmetrics]
      processors: []
      exporters: [otlphttp/withauth, otlp/withauth]

設定

次の表は、oauth2client エクステンションの設定オプションを示しています：

トラブルシューティング