Confluenceトークンの生成

Knowledge Hubナレッジベースに接続するには、NiCEプロフェッショナルサービスに資格情報を提供するか、自分でKnowledge Hubに入力必要があります。このページでは、これらの資格情報 (OAuth トークンとも呼ばれます) を生成する方法について説明します。 OAuthトークンはパスワードのように扱う必要があります。必ず安全な場所に保管してください。失った場合は、再生する必要があります。

このメソッドは開発者の努力によるものです。 Python と Atlassian 管理者権限の知識が必要です。

これらの各タスクを指定された順序で実行します。

Pythonをインストールする

コンピューターにPythonがまだインストールされていない場合は、このタスクを完了します。

Python をインストールします。
インストーラーを実行します。パスにpython.exeを追加する]のボックスを選択し、今のインストールをクリックします。

認証の設定

この方法は、Confluenceとの基本的な連携に使用します。 API トークンを作成するには、次の手順を実行します。

Atlassian アカウント設定ページに移動します。
セキュリティタブを選択します。
APIトークンページで、APIトークンの作成を選択します。
APIトークンの作成ダイアログボックスで、次の操作を行います。
- トークンの名前を入力します。
- トークンの有効期限を指定します。
- 作成を選択します。
システムはAPIトークンを生成します。

注:APIトークン最大1年間有効です。中断を避けるために、有効期限が切れる前に必ず更新してください。
トークンをコピーして、安全な場所に保存します。

メモ: ダイアログボックスを閉じると、トークンを再び表示することはできません。

OAuth認証の設定

OAuth認証を設定するには、次の手順に従って、Confluence 2.0と呼ばれるセキュアなログイン方法を使用して、OAuthへの安全かつ制限付きアクセスを有効にします。

Atlassian Developer Console に移動し、Atlassian アカウントでサインインします。
アプリを作成または選択します。
- アプリを作成していない場合:
  - 作成を選択します。
  - ドロップダウンメニューから、アプリタイプとしてOAuth 2.0(3LO)を選択します。
  - アプリの名前と説明を入力します。
  - 作成を選択して終了します。
- すでにアプリをお持ちの場合:
  - マイアプリリストからアプリを選択します。
アプリの概要ページに移動し、左側のナビゲーションウィンドウで権限を選択します。
- Confluence APIで追加を選択し、構成を選択します。
- 必要なスコープを有効にします。
  - クラシック スコープの場合は、[編集を選択し、すべての読み取りアクセス許可を有効にします。
  - きめ細かなスコープの場合は、[編集を選択し、すべての読み取りアクセス許可を有効にします。
- 保存を選択して、スコープ設定を適用します。
左側のナビゲーションペインで、承認を選択します。
- OAuth 2.0 (3LO)で、追加を選択します。
- コールバックURLフィールドに、次のように入力します。
  - https://us-west-2.console.aws.amazon.com/appflow/oauth
- 変更を保存を選択します。
左側のナビゲーションペインで、設定を選択します。
認証詳細セクションに移動し、クライアントIDとシークレットキーをコピーします。

ユーザーおよびグループアクセスの設定

このセクションでは、Atlassian Admin Console でユーザーの追加、製品アクセスの割り当て、グループメンバーシップの管理を行って、Confluenceへの適切なアクセスを確保する方法について説明します。

ユーザーを追加するには:
- に移動しますAtlassian Admin Console 。
- 左側のナビゲーションペインで、[ディレクトリ] を選択し、[ユーザー] を選択します。
- ユーザーを招待するを選択します。
- 招待するユーザーのメールアドレスを入力します。
- 製品アクセスで Confluence を選択してサイトアクセスを許可します。
- 招待状を送信を選択します。
メモ: ユーザーは、アカウントをアクティブ化するために招待を受け入れる必要があります。
ユーザーを追加したら、適切な製品ロールを割り当てて、アクセスレベルを制御します。製品アクセス権を割り当てるには:
- ユーザーリストで、ユーザーの名前を選択します。
- ユーザープロファイルページで、製品アクセスタブを選択します。
  メモ: Confluenceが選択されていることを確認します。
- ユーザーの責任に基づいて適切なロールを割り当てます。たとえば、ユーザー、管理者などです。
ユーザーをグループに追加するには
- 左側のナビゲーションペインで、[ディレクトリ] を選択し、[グループ] を選択します。
- 管理するグループを選択します。
- メンバーを追加を選択します。
- 名前またはEメールアドレスでユーザーを検索します。
- ユーザーを選択し、追加を確認します。
グループベースのアクセスにより、複数のスペースや製品にわたる権限管理が簡素化されます。

グループメンバーシップは、権限とアクセスレベルを効率的に管理するのに役立ちます。推奨グループは次のとおりです。

グループ名	目的
コンフルエンス管理者サービス11	管理者アクセス
confluence-user-access-admins-servion11 (英語)	ユーザーアクセスの管理
コンフルエンスユーザーサービス 11	一般的なユーザーアクセス
組織管理者	組織レベルの管理者

Python を使用したOAuthトークンの生成

このTXTファイルのPythonスクリプトを使用して、APIにアクセスするための認証トークンを生成します。スクリプトを実行する前に、client_idとclient_secretのプレースホルダー値を実際の資格情報に置き換えてください。

ノート: リダイレクトURIが開発者コンソールで設定されたものと一致していることを確認します。

Confluence でのスペースレベルの権限の構成

Confluenceのスペースレベルの権限を使用すると、特定のスペース内のコンテンツを表示、編集、または管理できるユーザーを制御できます。スペースの権限を設定するには、次の手順に従います。

Confluence資格情報を使用してスペースにログインします。
左側のナビゲーションペインで、管理するスペースを見つけてクリックします。
スペース内で、スペース設定をクリックします。
スペースアクセスセクションまでスクロールし、ユーザーをクリックします。これにより、ユーザーまたはユーザーグループの権限を追加または削除できるインターフェイスが開きます。
編集をクリックし、表示アクセスを有効にします。
適切な権限を割り当てたら、保存をクリックします。

アクセストークンの期限切れ

アクセストークンの有効期限が切れている場合、API呼び出しを行うことはできません。これを修正するには、AtlassianDeveloper Console 外部サイトへのナビゲーションを示す矢印付きのボックス。に移動し、新しいトークンを生成します。