Drupal について
Iru は Drupal コアの JSON:API(/jsonapi)を使用して、コンテンツタイプ、ノード、ユーザー、ロール、および関連するメタデータを取得します。Drupal 8.7 以降 には JSON:API がコアに含まれています。Extend で有効にしてください。認証には HTTP Basic(ユーザー名 + パスワード)を使用します。認証情報が平文で送信されないよう、サイトは HTTPS で提供してください。
仕組み
公式リファレンス: JSON:API モジュール、権限モデル。
前提条件
- JSON:API が有効になっており、
https://YOUR_HOST/jsonapiがリソース検出用の JSON を返すこと。 - 対象となるバンドルに対して GET を実行できるロールを持つ Drupal ユーザー。
Drupal を Iru に接続する
- Drupal
- Iru Compliance
Compliance でソースを接続する前に、このタブの手順を完了してください。
1
管理者としてサインインする
モジュールのインストールと構成の変更ができるユーザー(Administrator または同等の権限)で Drupal サイトにサインインします。
2
Extend(モジュール)を開く
管理 → Extend(管理テーマによっては Administration → Extend)に移動します。
3
JSON:API を有効にする
JSON:API モジュールを見つけます。モジュールを有効にし、Drupal から求められた構成のインポートやキャッシュの再構築を実行します。
4
権限を確認する
Iru が使用する連携用のユーザーまたはロールが、コントロールに必要な JSON:API リソースに対して GET を実行できることを確認します(Anonymous では範囲が広すぎることが多いため、最小限の読み取り権限を持つ専用のサービスアカウントを推奨します)。
5
JSON:API エンドポイントを確認する
ブラウザまたは
curl で、サイトの検出ドキュメント(例: https://YOUR_HOST/jsonapi)をリクエストし、Drupal が JSON を返すこと(403 や 404 ではないこと)を確認します。Iru Compliance タブに進んでください。
トラブルシューティング
ソースをオンにしても何も開かない
ソースをオンにしても何も開かない
Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
/jsonapi で 404 が返される
/jsonapi で 404 が返される
JSON:API モジュールを有効にしてください。
リソースで 403 が返される
リソースで 403 が返される
関連するエンティティタイプに対する view 権限を付与してください。
401
401
パスワードを修正してください。Drupal では大文字と小文字が区別されます。
考慮事項
必要な範囲にスコープされた読み取り専用のサービスアカウントを推奨…
必要なコンテンツタイプにスコープされた 読み取り専用 のサービスアカウントの使用を推奨します。
関連記事
Sources の管理
すべての Compliance ソースを参照、管理します。
Compliance を使い始める
フレームワーク、アクション、アーティファクト。
Iru の概要
Endpoint、Compliance、Identity がどのように連携するか。
Artifacts の管理
ソースやアクションから得たエビデンスをアップロード、確認、整理します。
