登録と所有権

概要

プライベートアクションランナーが起動すると、Datadog 組織に登録されます。ランナーは自身を登録し、すべてのリクエストで認証に使用する ID を受け取ります。登録によってランナーの所有権も設定され、所有権によって、その後のランナーの存続期間中に使用される認可モデルが決定されます。ランナーの所有権は再登録なしでは変更できないため、デプロイ前に登録方法を慎重に選択してください。

登録は両方のランナー形式に適用されます。所有者なしの登録と、それに続く実行ポリシーによる認可は、Datadog Agent 内のランナーにのみ適用されます。スタンドアロンランナーは常に所有されます。

登録プロセス

  1. 資格情報と、それを有効にする構成を使用してランナーを起動します。
  2. ランナーが Datadog に登録されます。デフォルトでは (`self_enroll: true)、手動の手順なしで起動時に自動的に行われます。
  3. Datadog はランナーに ID を発行します: 。一意のランナー識別子とキーペア。ランナーはこの ID を保持し、その後の再起動時に再利用します。
  4. ランナーは自身の ID を使用して Datadog で認証を行い、受信したタスクを検証します。

自己登録を使用する代わりにランナーの ID を自分で事前プロビジョニングするには、構成オプションを参照してください。

登録タイプと所有権

ランナーを登録するには 2 つの方法があります。登録に使用する資格情報によってランナーの所有権が設定され、所有権によって認可モデルが決定されます。単一のランナーは、両方ではなく、いずれか一方のモデルによって認可されます。所有権は登録時に一度だけ設定され、ランナーの存続期間中固定されます。所有権を変更するには、別の資格情報タイプを使用してランナーを再登録してください。デプロイ前にどのモデルを使用するかを決定し、対応する資格情報で登録してください。2 つのモデルの詳細な比較については、プライベートアクションの認可を参照してください。

登録方法ランナーの所有権認可モデル
API キー (プライベートアクションランナー機能を持つ)所有者なし実行ポリシー
API キーおよびアプリケーションキー所有者ありコネクション

所有者なしランナー

プライベートアクションランナー機能を持つ API キーで登録されたランナーは所有者なし: となり、個別の所有者は存在しません。所有者なしランナーは実行ポリシーで認可されます。実行ポリシーは、フリート全体の Agent タグによるアクセスを制御します。所有者なしの登録は、Datadog Agent 内のランナーに適用されます。

Private Action Runner 機能は、Remote Configuration と同様にバッジで表示されます。これを管理するには、API キーの権限である API Keys Read (api_keys_read) および API Keys Write (api_keys_write) が必要です。詳細については、API およびアプリケーションキーの権限を参照してください。

所有者なしランナーを登録するには、

  1. Datadog で、Organization Settings > API Keys に移動します。
  2. API キーを作成または選択し、Private Action Runner 機能を有効にします。
  3. その API キーでランナーを構成し、API キーのみの登録を有効にします。デプロイ手順および必要な Agent バージョンについては、Datadog Agent でのプライベートアクションランナーのセットアップを参照してください。

Kubernetes では、ランナーが読み取るシークレットに API キーを保存します。

kubectl create secret generic datadog-secret \
  --from-literal api-key=<DD_API_KEY>

所有者ありランナー

アプリケーションキーで登録されたランナーは所有者ありとなり、登録したユーザーがそのランナーの所有者となります。所有者ありランナーは、コネクションで認可されます。登録中、Datadog はランナーの許可リストにあるインテグレーションの接続を作成するため、ランナーはそれらのインテグレーションですぐに使用できるようになります。

所有者あり登録は一般提供されているパスであり、スタンドアロンランナーと Datadog Agent 内のランナーの両方で機能します。

Kubernetes では、ランナーが読み取るシークレットに API キーとアプリケーションキーを保存します。

kubectl create secret generic datadog-secret \
  --from-literal api-key=<DD_API_KEY> \
  --from-literal app-key=<DD_APP_KEY>

所有者ありランナーへのアクセスの管理

このセクションは所有者ありランナーにのみ適用されます。所有者なしランナーには個別の所有者が存在しません。代わりに、実行ポリシーによって、誰がそのランナーに対してアクションを実行できるかが制御されます。

ロールベースのアクセス制御 (RBAC) を使用して、所有者ありランナーへのアクセスを制御します。ランナーに権限を設定して、変更を制限したり、新しい接続が追加されるのを防いだりできます。デフォルトでは、ランナーの作成者のみが Editor アクセス権を持ちます。作成者は、他のユーザー、サービスアカウント、ロール、またはチームにアクセス権を付与できます。プライベートアクションランナーに適用される権限のリストについては、Datadog ロール権限を参照してください。

権限レベル

Viewer
ランナーおよびそれに接続されている接続を表示できます。
Contributor
ランナーを表示し、新しい接続を追加してランナーに貢献できます。
Editor
ランナーを表示し、コントリビュート (新しい接続の追加) し、編集できます。

ランナーの権限を設定する

  1. ランナーの Edit ページに移動します。
  2. **Who Has Access?**セクションで、Edit access をクリックします。
  3. ドロップダウンメニューからユーザー、サービスアカウント、ロール、またはチームを選択し、Add をクリックします。選択したプリンシパルがダイアログボックスの下部に表示されます。
  4. プリンシパル名の横にあるドロップダウンメニューから、必要な権限を選択します。
  5. プリンシパルからアクセス権を削除するには、権限のドロップダウンメニューから Remove access を選択します。
  6. Done をクリックして、権限の設定を確定します。
  7. Save をクリックして、新しい権限をランナーに適用します。

構成オプション

以下の設定で登録を制御します。ランナー設定とそのデフォルト値の完全なリストについては、プライベートアクションランナーリファレンスを参照してください。

設定目的
self_enroll起動時に自動的に登録します。デフォルトで有効です。
api_key_only_enrollmentPrivate Action Runner 機能を持つ API キーを使用して、所有者なしランナーとして登録します。
actions_allowlistランナーが実行を許可されているアクションです。所有者ありランナーの場合、Datadog は登録時にこれらのインテグレーションの接続を作成します。

Kubernetes 上の ID ストレージ

Datadog Agent のランナーは、再起動後も維持されるようにそのアイデンティティを保持します。ID がどこに保存されるかは、ランナーによって異なります。

  • Cluster Agent ランナー: アイデンティティを Kubernetes シークレットに保存するため、アイデンティティは Cluster Agent のレプリカ間で共有されます。Helm または Datadog Operator でインストールした場合、デフォルトのシークレット名は datadog-private-action-runner-identity です。
  • Node Agent ランナー: アイデンティティをファイルに保存します。Kubernetes では、Pod の再起動後もアイデンティティが維持されるように、そのパスを永続ボリュームでバックアップしてください。

ランナーのアイデンティティとタスク認証

登録により、各ランナーには Datadog が一切アクセスできない秘密鍵が付与されます。Datadog は対応する公開鍵を使用してランナーを認証するため、お客様の組織のタスクは、お客様のランナーのみが取得できるようになっています。

Datadog はディスパッチするすべてのタスクに署名し、ランナーはタスクを実行する前にその署名を検証します。

プライベートランナーの認証情報のローテーション

再デプロイせずにプライベートランナーの認証情報をローテーションするには、環境に応じたコマンドを実行します。

  • Linux ホスト: /opt/datadog-packages/datadog-agent/stable/embedded/bin/privateactionrunner rotate-identity
  • コンテナ (Node Agent を含む): /opt/datadog-agent/embedded/bin/privateactionrunner rotate-identity
  • Cluster Agent: /opt/datadog-agent/bin/datadog-cluster-agent rotate-par-identity

参考資料