Contentful について
Iru は、Authorization: Bearer として送信される個人用アクセストークン（PAT）を使用して、Content Management API (CMA) 経由でスペース、コンテンツモデル、環境、メンバーシップを読み取ります。Content Delivery API (CDA) のプレビュートークンは管理スコープを持たないため、使用しないでください。
仕組み
公式の参考資料: 認証、個人用アクセストークン、CMA リファレンス。
前提条件
- エビデンスに必要なスペースにアクセスできる Contentful ユーザー。
Contentful を Iru に接続する
- Contentful
- Iru Compliance
Compliance でソースを接続する前に、このタブを完了してください。
1
Contentful にサインインする
Contentful Web アプリを開き、Iru に読み取らせるスペースにアクセスできるユーザーでサインインします。
2
設定を開く
トークンを所有する組織またはスペースの 設定（UI に応じて歯車アイコンまたはワークスペースの設定）を選択します。
3
CMA トークンを開く
CMA tokens（Content Management API トークン）または同等の Personal access tokens 画面を選択します。
4
個人用アクセストークンを作成する
Create personal access token（または トークンを生成）を選択します。Iru Compliance などの名前を入力します。
5
有効期限を設定する（任意）
Contentful で有効期限を設定できる場合は、キーのローテーションポリシーに合わせた日付を設定します。セキュリティチームが無期限のトークンを許可している場合に限り、未設定のままにしてください。
6
トークンを生成してコピーする
トークンを生成し、値を一度だけコピーします。安全に保管してください。Iru に Bearer トークンとして貼り付けます。
Iru Compliance タブに進みます。
トラブルシューティング
ソースをオンにしても何も開かない
ソースをオンにしても何も開かない
Iru サイトのポップアップブロッカーの設定を確認してから、もう一度お試しください。
PAT の有効期限が切れている
PAT の有効期限が切れている
設定 → CMA tokens でローテーションし、Iru を更新してください。
スペースが表示されない
スペースが表示されない
PAT はユーザーのメンバーシップを継承します。先にスペースへのアクセス権を付与してください。
考慮事項
漏洩したトークンはすぐに取り消して再作成してください: PUT…
漏洩したトークンはすぐに取り消して再作成してください。自動化には、Contentful がドキュメント化している PUT の取り消しエンドポイントを使用できます。
関連記事
Sources の管理
すべての Compliance ソースを参照・管理します。
Compliance の利用を開始する
フレームワーク、アクション、アーティファクト。
Iru の概要
Endpoint、Compliance、Identity がどのように連携するか。
Artifacts の管理
ソースやアクションから得たエビデンスをアップロード、確認、整理します。