組織認証・所有権証明
概要
実環境への動的な通信を伴う機能（ブラックボックス診断を含む）を利用するためには、事前に組織認証、あるいは通信対象ごとの所有権証明のいずれかが必要です。
組織認証
組織認証は、ある Shisho Cloud 組織を、どの法人が利用しているかを紐づける仕組みです。
組織認証を得るには、提供元（GMO Flatt Security）に申請する必要があります。 組織認証の承認は通常2〜3営業日以内に完了します。
組織認証を得ると、実環境 への動的な通信を伴う機能（ブラックボックス診断を含む）を、通信対象ごとの所有権証明を行わずに利用できます。
組織認証を得た場合であっても、実環境への動的な通信を伴う機能を利用するためには、利用規約およびその他関連法令に従いご利用いただく必要があります。
一つの Shisho Cloud 組織に対して紐づけられるのは、一つの法人のみです。以下を含む、複数法人が関連するシナリオで利用いただくことは可能ですが、利用規約の定め（利用にかかる適法な権利の確保、関連する役職員等へ規約の周知・遵守させることを含みます。）に従ってご利用ください。
- 紐づけられた法人が、その他の法人のためにShisho Cloud組織を利用する（例: セキュリティ診断を営む企業が診断に利用する）
- 紐づけられた法人が、その他の法人等に 、業務委託等の形でShisho Cloud組織を利用させる（例: 関連会社間のガバナンスのために利用する）
通信対象ごとの所有権証明
現時点で組織の認証が難しい場合（個人利用の場合等）でも、診断対象のアプリケーションの所有権を証明いただくことで、実環境への動的な通信を伴う機能を利用いただけます。
組織がすでに認証済みの場合は、所有権証明を伴わず、実環境への動的な通信を伴う機能を利用いただけます。
対象ごとの所有権証明を行うには、組織オーナーまたはTakumiマネージャー権限が必要です。通常のメンバーは、すでに所有権証明済みの対象アプリケーションに対してのみ、機能を利用できます。権限を有さない場合、下記の所有権証明トークンおよび所有権証明実行フォームにはアクセスできません。
所有権証明されていないアプリケーションの対象URLを入力すると、エラーが表示され、診断を実行できません。
所有権証明の手順
診断対象の所有権を証明するには、対象URL入力欄の下にある新しい対象の所有権を証明セクションまでスクロールしてください。
そこで、対象アプリケーションの所有権証明に使用するトークンを確認できます。
この所有権証明トークンを以下の2つの方法のいずれかで設定し、所有権証明プロセスを進めてください。
1) DNS TXTレコード所有権証明
サブドメイン _takumi-ownership.<your-domain> に、所有権証明トークンを値としてDNS TXTレコードを追加してください。
例えば、対象ドメインが example.com でトークンが 0123ABCD の場合、_takumi-ownership.example.com に対して値 0123ABCD のTXTレコードを作成します。
設定が完了したら、対象の所有権証明セクションで「DNS TXTレコード」を検証方法として選択し、ホスト名を入力して「対象を検証」をクリックしてください。
2) HTTP Well-Knownディレクトリ所有権証明
対象サーバーのwell-knownパス /.well-known/takumi-ownership に、所有権証明トークンのみをファイル内容として含むファイルを作成してください。
例えば、対象が https://example.com でトークンが 0123ABCD の場合、https://example.com/.well-known/takumi-ownership にファイルを作成してください。
ファイルには、トークン 0123ABCD のみを含め、その他のデータを含めてはいけません。
このファイルはHTTP/HTTPS経由でアクセス可能である必要があります。
また、トークンをプレーンテキストとして 200 OK レスポンスを返す必要があります。
設定が完了したら、対象の所有権証明セクションで「HTTP Well-Known」を検証方法として選択し、ホスト名を入力して「対象を検証」をクリックしてください。
ポート番号を指定しない場合、HTTPSの場合はポート443、HTTPの場合 はポート80がデフォルトで使用されます。
状態の確認
対象の所有権を検証をクリックすると、所有権証明結果のレスポンスが表示され、下部の対象の所有権証明状態セクションに指定した対象の所有権証明状態が更新されます。
所有権証明に失敗した場合、各対象の直近の所有権証明失敗理由が同じセクションに表示されます。不明または予期しないエラーが返された場合は、お問い合わせください。
所有権証明後、ユーザーは診断対象のURLセクションに検証済みの対象アプリケーションを入力し、診断の実行に進むことができます。
対象の所有権証明を同一ターゲットに試行した後、10秒間のクールダウンがありますので、時間をおいて再度試行ください。
所有権証明に成功したものの、「診断対象のURL」に入力した際に対象が所有権証明されていない旨の表示がされる場合、一度診断作成画面を再読み込みいただき、再度ご確認ください。