Skip to main content

Confluence Cloud について

Confluence Cloud コネクタは、アクセスレビューや変更管理のエビデンスに必要なスペース、ページ、メンバーシップのデータを収集します。ウィザードは 2 つのパートで構成されています。まず、Iru が https://YOUR_SUBDOMAIN.atlassian.net/wiki/api/v2 にアクセスできるように *.atlassian.net のサブドメインを入力し、次に Atlassian のメールアドレスと API トークンから構成される HTTP Basic 認証情報を入力します。

仕組み

REST 呼び出しでは Basic 認証を使用します。
パスワードは受け付けられません。API トークンのみが使用できます。 ドキュメント: Confluence Cloud の Basic 認証、REST v2 の概要、API トークン。

前提条件

  • エビデンスの取得対象となるスペースへのアクセス権。
  • お客様のサブドメイン(.atlassian.net の前にあるラベル。例: ユーザーが https://acme.atlassian.net/wiki にアクセスする場合は acme)。

Confluence Cloud を Iru に接続する

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 サイトのポップアップブロッカーの設定を確認してから、もう一度お試しください。
ディープリンクの有効期限が切れている場合は、ソースをオフにしてからオンに戻してウィザードを更新してください。
メールアドレスは Atlassian ID と一致している必要があります。パスワードフィールドには API トークンを入力する必要があります。
トークンはお客様のスペースの権限を継承します。アカウントにアクセス権を付与するか、別の ID に切り替えてください。
ユーザーが使用しているホスト名を再確認してください。入力ミスがあると、すぐにルーティングが失敗します。

考慮事項

トークンは毎年期限切れになるため、期限前にローテーションしてください。

トークンは毎年期限切れになります。期限前にローテーションしてください。

Data Center / Server の API は異なり、このコネクタは…

Data Center / Server の API は異なります。このコネクタは Cloud のみを対象としています。

関連記事

Sources の管理

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

Compliance の利用を開始する

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

Iru の概要

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

Artifacts の管理

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