Skip to main content

​
Notion について

Notion コネクタは、ページのメタデータ、データベースのスキーマ、ワークスペースのメンバーシップ、インテグレーションの構成を読み取り、ナレッジベースのエビデンスを Iru Compliance のコントロールにマッピングできるようにします。認証には、My integrations で生成した Notion 内部インテグレーショントークン（接続シークレットと呼ばれることもあります）を使用します。

​
仕組み

Notion は、トークンが Authorization ヘッダーに含まれていることを想定しています:
内部インテグレーションは、インテグレーションと明示的に 共有 したコンテンツにのみアクセスできます。共有は計画的に行ってください。通常は、子ページがアクセス権を継承するよう、親ページ にインテグレーションを接続します。 ドキュメント: インテグレーションの作成、認可の概要、API リファレンス。

​
前提条件

  • ワークスペースオーナー 権限（インテグレーションの作成に必要）。
  • コンプライアンスのエビデンスに含める ページまたはデータベース の明確なリスト。

​
Notion を Iru に接続する

Compliance でソースを接続する前に、このタブの手順を完了してください。
1

Notion にサインインする

Iru に読み取らせるワークスペースの 内部インテグレーション を作成できるユーザーで、notion.so にサインインします。
2

My integrations を開く

notion.com/my-integrations にアクセスするか、Notion アプリで 設定 → Connections を開き、インテグレーションの 作成 または管理に進みます。
3

インテグレーションを構成する

新しいインテグレーションを作成します。名前（例: Iru Compliance）を付け、正しいワークスペース に割り当て、コントロールに必要な機能を有効にします。少なくとも Read content を有効にし、メンバーシップのエビデンスが重要な場合は Read user information including email addresses も有効にします。
4

保存して内部インテグレーションシークレットをコピーする

インテグレーションを 保存 し、内部インテグレーションシークレット をコピーします。パスワードと同様に扱ってください。ローテーションするかインテグレーションを削除しない限り、失効しません。
5

インテグレーションとコンテンツを共有する

各トップレベルのページまたはデータベースを開き、⋯ → Connections → Iru Compliance を選択します。親ページを共有すると、ネストされたドキュメントでの重複作業を減らせます。明示的に共有しない限り、たとえユーザーがページを読み取れる場合でも、インテグレーションからは当然 何も 表示されません。
Iru Compliance タブに進んでください。

​
トラブルシューティング

Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
シークレットをコピーし直し、インテグレーションが削除またはローテーションされていないことを確認してください。
各親ページを開き直し、Connections にインテグレーションが表示されていることを確認してください。
インテグレーションを管理できるのはワークスペースオーナーのみです。意図したワークスペースで作成したことを確認してください。

​
考慮事項

スケジュールに従ってシークレットをローテーションし、Iru を更新…

スケジュールに従ってシークレットをローテーションし、その後すぐに Iru を更新してください。

Iru はトークンに公開されたメタデータを読み取り…

Iru はトークンに公開されたメタデータを読み取ります。ページや招待を密かに編集することはありません。

​
関連記事

Sources の管理

すべての Compliance ソースを参照、管理します。

Compliance を使い始める

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

Artifacts の管理

ソースやアクションから得たエビデンスをアップロード、確認、整理します。