シングルサインオン on DefectDojo Documentation

Authorization Connectors

Mon, 01 Jan 0001 00:00:00 +0000

Authorization Connectorsは、DefectDojo Proが対応するすべてのIDプロバイダーと、それぞれの状態、使用しているプロトコルを1つのページにまとめて表示します。これが存在する前は、各プロバイダーはそれぞれ独自の設定フォームに存在しており、すべてを開かない限り「このインスタンスで何が設定されているか」に答える方法がありませんでした。

Authorization ConnectorsはDefectDojo Proの機能です。Connect > Authorizationにあります。IDプロバイダーの設定を表示・変更できるのはスーパーユーザーのみです。

How the page is organised

プロバイダーは2つのセクションに分かれており、それぞれ見出しの横に件数が表示され、アルファベット順に並んでいます。

Configured Providers(設定済みプロバイダー) — 現在オンになっているかどうかにかかわらず、このインスタンスで設定済みのプロバイダー
Available Providers(利用可能なプロバイダー) — サポートされているが、まだ設定されていないプロバイダー

この区分はあえてenabled(有効)ではなくconfigured(設定済み)を基準にしています。設定した後にオフに切り替えられたプロバイダーはConfigured Providersに残ります。設定した本人がそこを探すはずだからです。状態はタイル上に表示されます。

SAML の設定

Mon, 01 Jan 0001 00:00:00 +0000

DefectDojo Pro は Enterprise Settings UI 経由での SAML 認証をサポートしています。オープンソース版の DefectDojo には SSO は含まれていません。オープンソース版のアクセス制御については Authorized Users を参照してください。

ACS URL (Assertion Consumer Service)

ユーザーが認証された後、SAML レスポンスをどこに POST すればよいかを ID プロバイダーが把握している必要があります。DefectDojo の ACS URL は次のとおりです。

Auth0

Mon, 01 Jan 0001 00:00:00 +0000

DefectDojo ProはAuth0によるログインをサポートしています。オープンソース版のDefectDojoにはSSOは含まれていません。オープンソース版のアクセス制御についてはAuthorized Usersを参照してください。

Prerequisites

DefectDojoを設定する前に、Auth0ダッシュボードで以下の手順を完了してください。

Create a new application: Applications > Create Application > Single Page Web Application.
Configure the application:

Azure Active Directory

Mon, 01 Jan 0001 00:00:00 +0000

DefectDojo ProはAzure Active Directory(Azure AD)によるログインをサポートしており、ユーザーグループの自動同期も含まれます。オープンソース版のDefectDojoにはSSOは含まれていません。オープンソース版のアクセス制御についてはAuthorized Usersを参照してください。

Prerequisites

DefectDojoを設定する前に、Azureポータルで以下の手順を完了してください。

Azure Active Directoryで新しいアプリを登録します。
登録したアプリから以下の値を控えます。
- Application (client) ID
- Directory (tenant) ID
- Certificates & Secretsで新しいClient Secretを作成し、その値を控えます
- Application ID URI
Authentication > Redirect URIsで、WebタイプのURIを追加します。 https://your-instance.cloud.defectdojo.com/complete/azuread-tenant-oauth2/

GitHub Enterprise

Mon, 01 Jan 0001 00:00:00 +0000

DefectDojo ProはGitHub Enterpriseによるログインをサポートしています。オープンソース版のDefectDojoにはSSOは含まれていません。オープンソース版のアクセス制御についてはAuthorized Usersを参照してください。

Prerequisites

DefectDojoを設定する前に、GitHub Enterpriseで以下の手順を完了してください。

GitHub Enterprise Serverで新しいOAuthアプリを作成します。
アプリケーションの名前を選びます(例: DefectDojo)。
Redirect URIを設定します。 https://your-instance.cloud.defectdojo.com/complete/github-enterprise/
アプリからClient IDとClient Secretを控えます。

Configuration

DefectDojoでEnterprise Settings > OAuth Settingsに移動し、GitHub Enterpriseを選択してフォームに入力します。

GitLab

Mon, 01 Jan 0001 00:00:00 +0000

DefectDojo ProはGitLabによるログインをサポートしています。オープンソース版のDefectDojoにはSSOは含まれていません。オープンソース版のアクセス制御についてはAuthorized Usersを参照してください。

Prerequisites

DefectDojoを設定する前に、GitLabで以下の手順を完了してください。

GitLabプロフィールのApplicationsページに移動します。
- GitLab.com: https://gitlab.com/profile/applications
- セルフホスト: https://your-gitlab-host/profile/applications
新しいアプリケーションを作成します。
- Name: DefectDojo
- Redirect URI: https://your-dojo-instance.cloud.defectdojo.com/complete/gitlab/
アプリケーションからApplication IDとSecretを控えます。

Configuration

DefectDojoでEnterprise Settings > OAuth Settingsに移動し、GitLabを選択してフォームに入力します。

Google Auth

Mon, 01 Jan 0001 00:00:00 +0000

DefectDojo ProはGoogleアカウントによるログインをサポートしています。新規ユーザーは、初回ログイン時にまだ存在しない場合は自動的に作成されます。既存のDefectDojoユーザーは、Googleメールアドレスの@より前の部分(ユーザー名)によってGoogleアカウントと照合されます。オープンソース版のDefectDojoにはSSOは含まれていません。オープンソース版のアクセス制御についてはAuthorized Usersを参照してください。

Prerequisites

DefectDojoを設定する前に、Google Cloud Consoleで以下の手順を完了してください。

Google Developers Consoleにサインインします。
Credentials > Create Credentials > OAuth Client IDに移動します。
Web Applicationを選択し、分かりやすい名前(例: DefectDojo)を付けます。

KeyCloak

Mon, 01 Jan 0001 00:00:00 +0000

DefectDojo ProはKeyCloakによるログインをサポートしています。オープンソース版のDefectDojoにはSSOは含まれていません。オープンソース版のアクセス制御についてはAuthorized Usersを参照してください。

このガイドは、KeyCloak Realmがすでに設定済みであることを前提としています。未設定の場合はKeyCloak documentationを参照してください。

Prerequisites

DefectDojoを設定する前に、KeyCloak Realmで以下の手順を完了してください。

タイプopenid-connectで新しいクライアントを追加します。クライアントIDを控えます。
クライアント設定で以下を行います。
- Access Typeをconfidentialに設定します
- Valid Redirect URIsにDefectDojoのURL(例: https://yourorganization.cloud.defectdojo.comまたはhttps://your-dojo-host/*)を追加します
- Web Originsに同じURL(または+)を追加します
- Fine Grained OpenID Connect Configurationで以下を設定します。
  - User Info Signed Response AlgorithmをRS256に設定
  - Request Object Signature AlgorithmをRS256に設定
- 設定を保存します。
ScopeでFull Scope Allowedをoffに設定します。

Okta

Mon, 01 Jan 0001 00:00:00 +0000

DefectDojo Pro は Okta 経由のログインをサポートしています。オープンソース版の DefectDojo には SSO は含まれていません。オープンソース版のアクセス制御については Authorized Users を参照してください。

Prerequisites

DefectDojo を設定する前に、Okta 側で以下の手順を完了してください。

Okta にサインインするか、アカウントを作成します。
Applications に移動し、Add Application をクリックします。

OIDC

Mon, 01 Jan 0001 00:00:00 +0000

DefectDojo Pro は、汎用の OpenID Connect (OIDC) プロバイダーを介したログインをサポートしています。オープンソース版の DefectDojo には SSO は含まれていません。オープンソース版のアクセス制御については Authorized Users を参照してください。

Configuration

DefectDojo で Enterprise Settings > OIDC Settings に移動します。