Confluence Cloud について
Confluence Cloud コネクタは、アクセスレビューや変更管理のエビデンスに必要なスペース、ページ、メンバーシップのデータを収集します。ウィザードは 2 つのパートで構成されています。まず、Iru がhttps://YOUR_SUBDOMAIN.atlassian.net/wiki/api/v2 にアクセスできるように *.atlassian.net のサブドメインを入力し、次に Atlassian のメールアドレスと API トークンから構成される HTTP Basic 認証情報を入力します。
仕組み
REST 呼び出しでは Basic 認証を使用します。
ドキュメント: Confluence Cloud の Basic 認証、REST v2 の概要、API トークン。
前提条件
- エビデンスの取得対象となるスペースへのアクセス権。
- お客様のサブドメイン(
.atlassian.netの前にあるラベル。例: ユーザーがhttps://acme.atlassian.net/wikiにアクセスする場合はacme)。
Confluence Cloud を Iru に接続する
- Confluence Cloud
- Iru Compliance
Compliance でソースを接続する前に、このタブを完了してください。
1
Atlassian API トークンを開く
Confluence Cloud で使用している同じ Atlassian アカウントにサインインした状態で、ブラウザで id.atlassian.com/manage/api-tokens にアクセスします。
2
API トークンを作成する
Create API token(または トークンを作成)を選択します。Atlassian から再度のサインインや本人確認を求められる場合があります。
3
トークンに名前を付ける
後で迷わずに正しい認証情報を取り消せるように、Iru Compliance などのラベルを入力します。
4
有効期限を設定する
最長 365 日(執筆時点でのこのトークンタイプにおける Atlassian の上限)の有効期限を選択します。有効期限を短くすると、シークレットが漏洩した場合の影響範囲を抑えられます。
5
作成してシークレットをコピーする
作成を完了し、Atlassian に表示されたときにトークンの値を一度だけコピーします。Iru Compliance タブの Iru の Basic 認証の手順で、Atlassian アカウントのメールアドレスと組み合わせて使用します。
Iru Compliance タブに進みます。
トラブルシューティング
ソースをオンにしても何も開かない
ソースをオンにしても何も開かない
Iru サイトのポップアップブロッカーの設定を確認してから、もう一度お試しください。
サーバー変数のエラー
サーバー変数のエラー
ディープリンクの有効期限が切れている場合は、ソースをオフにしてからオンに戻してウィザードを更新してください。
スペースが表示されない
スペースが表示されない
トークンはお客様のスペースの権限を継承します。アカウントにアクセス権を付与するか、別の ID に切り替えてください。
サブドメインが間違っている
サブドメインが間違っている
ユーザーが使用しているホスト名を再確認してください。入力ミスがあると、すぐにルーティングが失敗します。
考慮事項
トークンは毎年期限切れになるため、期限前にローテーションしてください。
トークンは毎年期限切れになります。期限前にローテーションしてください。
Data Center / Server の API は異なり、このコネクタは…
Data Center / Server の API は異なります。このコネクタは Cloud のみを対象としています。
関連記事
Sources の管理
すべての Compliance ソースを参照・管理します。
Compliance の利用を開始する
フレームワーク、アクション、アーティファクト。
Iru の概要
Endpoint、Compliance、Identity がどのように連携するか。
Artifacts の管理
ソースやアクションから得たエビデンスをアップロード、確認、整理します。
