継続は力なり

タイトル通り定期的な更新を心掛けるブログです。

Datadog の SSO と SAML Group Mappings を Microsoft EntraID で構成したメモ✍

タダです.

Datadog のユーザーやロール管理を Microsoft EntraID(以降 EntraID)を IdP にして構成した際の設定方法をメモにまとめます.具体的には Datadog のログインを Single Sign On を行えるようにしつつ SCIM プロビジョニングで Datadog にユーザーを同期します.あわせて Datadog SAML Group Mappings で EntraID のグループと Datadog のロールをマッピングして権限を付与します.この記事では Single Sign On と Datadog SAML Group Mappings の設定を構成する設定について記載します.

EntraID 側の設定

まず EntraID 側で Datadog org 毎の Enterprise Application の追加を行います.追加の方法はドキュメントに沿って行うため割愛します.EntraID で Datadog 用の Enterprise Application を作成後,Datadog で利用するグループを割り当てます.例として次のようなグループを設定したとします.

  • 運用管理を行うメンバーが登録されているグループ
  • 通常の開発・調査を行うメンバーが登録されているグループ

次に基本的な SAML 設定では Datadog が指定する以下の順番で登録します.

  1. 基本的な SAML 構成に入力する値は以下の設定を行う
    • エンティティID: https://[設定先の org のカスタムサブドメインがあればそれを設定する]/account/saml/metadata.xml
    • 応答URL: https://[設定先の org のカスタムサブドメインがあればそれを設定する]/account/saml/assertion
    • サインオン URL: https://[設定先の org のカスタムサブドメインがあればそれを設定する]/account/login
  2. 属性とクレームに追加で アプリケーションに割り当てられているグループ を含めるようにする
  3. SAML 証明書を発行後,フェデレーション メタデータ XML ファイルをダウンロードする

Datadog 側の設定

SAML XML Metadata ファイルを登録し,SAML 設定を有効化する

次に Datadog 側の設定です.EntraID からダウンロードしたフェデレーションメタデータ XML ファイルを Datadog へ登録します.設定方法はドキュメントに沿って XML ファイルをアップロードするだけで完結します.設定後,SAML 設定が有効になっていることを確認します.

SAML Group Mappings の設定を行う

そして,SAML Group Mappings で SAML アサーションに含まれるグループ識別子を Datadog のロールにマッピングします.

docs.datadoghq.com

例として次のような権限体系を設けます.

  • 運用管理を行うメンバー:Datadog Admin Role
  • 通常の開発・調査を行うメンバー:Datadog Standard Role

この設定は Terraform で実現したので簡易なコードイメージは以下です.この設定を行って SAML Group Mappings のページで Role Mappings > Enable Mappings で有効化を行います.

data "datadog_role" "admin" {
  filter = "Datadog Admin Role"
}
data "datadog_role" "standard" {
  filter = "Datadog Standard Role"
}
resource "datadog_authn_mapping" "admin" {
  key   = "http://schemas.microsoft.com/ws/2008/06/identity/claims/groups"
  value = "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
  role  = data.datadog_role.admin.id
}

resource "datadog_authn_mapping" "standard" {
  key   = "http://schemas.microsoft.com/ws/2008/06/identity/claims/groups"
  value = "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"
  role  = data.datadog_role.standard.id
}

registry.terraform.io

この設定まできたら一度 Datadog の自身のユーザーでログアウトし,Login With SAML ボタンを押下してログインが成功するか,ロールマッピングが意図通りになっているかを確認します.

まとめ

Single Sign On と Datadog SAML Group Mappings の設定を構成する設定について書きました.次回は SCIM プロビジョニングの設定構成方法についてです.