Slackと統合

Slackと統合する理由

Oracle Content ManagementとSlackの統合により、Oracle Content Managementインスタンスに関連付けられたSlackのアプリケーションを作成できます。これにより、Slackを使用して、Oracle Content Managementに格納されているドキュメントを共有およびコラボレーションし、Slackユーザーに共有ドキュメントを表示、ダウンロードまたは編集する権限があるかどうかを制御できます。

前提条件

Oracle Content ManagementをSlackと統合するための前提条件があります。統合には通常、統合される両方のアプリケーションで構成が必要です。そのため、両方のドキュメントを確認してください。

Slack用のアプリケーションを作成するために必要なアカウントおよび権限が必要です。 Slack用のアプリケーションはOracle Content Managementと統合するときに使用され、アプリケーションの作成はSlack webサイト(https://api.slack.com/apps)で実行されます。
Oracle Content Management (OCM)側では、Oracle CloudアカウントとOCMインスタンスが必要であり、適切なアクセスroleが割り当てられます。

統合プロセス

SlackとOracle Content Managementの統合は、次のステップで構成されます:

「Oracle Content ManagementのSlackとの統合の有効化および構成」。特定のOracle Content Managementインスタンスに対して統合を構成する必要があります。
「Slack Webサイトを使用したSlackのアプリケーションの作成およびインストール」。アプリケーションを作成して特定のワークスペースまたはエンタープライズ「アプリ」としてインストールし、統合の構成時にマニフェストからコピーされたJSON形式の構成に貼り付ける必要があります。その後、アプリケーションをインストールすると構成が検証され、アプリケーション資格証明が生成されます。
「Oracle Content Managementへのアプリケーション資格証明の追加」。 Slackアプリケーションがインストールされると、Oracle Content Management統合構成ダイアログに入力する必要がある認証資格証明およびトークンが生成されます。

Oracle Content ManagementのSlackとの統合の有効化および構成

Slackとの統合はデフォルトで無効になっています。特定のOracle Content ManagementインスタンスをSlackのアプリケーションに関連付け、Oracle Content ManagementがSlack APIにアクセスできるようにアプリケーション資格証明を指定する必要があります。

サービス管理者としてOracle Content Management webインタフェースにログインします。
左側のナビゲーション・メニューの管理セクションで「統合」をクリックします。このオプションが表示されない場合は、必要なアクセス権限がありません。
Slackとの統合が有効になっていることを確認します。統合構成ダイアログが表示されない場合は、構成アイコンをクリックします。
Slack構成ダイアログとの統合の最初のページで、Slackのアプリケーションの名前、説明およびコマンド名を入力します。コマンド名は、Oracle Content Managementインスタンスへのアクセスをリクエストするために作成するスラッシュ/commandショートカットです(例: /sharecontent)。定義後は変更するのが困難であるため、コマンド名は慎重に選択してください。
「エンタープライズ・グリッド」を使用している場合は、「エンタープライズ組織アプリとして有効化」をチェックします。

ノート:
エンタープライズ組織アプリケーションとして有効になっている場合、Slackユーザーはアプリケーションを承認し、使用するワークスペースを選択する必要があります。これにより、組織がより厳格なセキュリティ要件を持つ非表示のワークスペースやワークスペースを持つ可能性があるため、制御が向上します。
「マニフェストの取得」をクリックします。

マニフェストは、入力した名前と説明、およびこの特定のOracle Content Managementインスタンスに関連付けられたリクエスト、イベントおよび認証リダイレクトを処理するためのSlackに必要なURLを含むJSON形式の構成です。
マニフェストに表示されているテキストを選択してコピーし、「保存」をクリックします。

ノート:

クライアントID、クライアント・シークレット、署名シークレットおよびOAuthトークンを指定するまで、Slack構成ダイアログとの統合を終了しないでください。これらのアプリケーション資格証明は、Slack webサイトにSlackアプリケーションを作成してアプリケーションをインストールするまで生成されません。

Slack Webサイトを使用したSlackのアプリケーションの作成およびインストール

Oracle Content Managementとの統合時に使用されるSlack用のアプリケーションの作成は、https://api.slack.com/appsのSlack webサイトで実行されます。 Slackアプリケーションを作成するには、必要なアカウントおよび権限が必要です。

Slackにサインインし、https://api.slack.com/appsに進みます。
「Create New App」をクリックします。
アプリ・マニフェストからアプリを作成することを選んでください。
組織アプリとしてインストールするか、アプリを作成するワークスペースを選択してください。これは、アプリケーションをインストールするワークスペースです。選択したら、「次」をクリックします。
SlackとのOracle Content Management統合を構成するときにコピーしたマニフェストで、サンプルのJSON形式のマニフェストを上書きし、「次」をクリックします。
サマリーを確認します。何か正しくない場合は、戻ってマニフェストを手動で編集する必要があります。
Oracle Content Managementアイコンを追加します:
1. Oracleコンテンツ配信ネットワーク(https://static.ocecdn.oraclecloud.com/cdn/cec/ocmslack/v 1.0.0 /images/ ocm-1024.png)からアイコンをダウンロードします。
2. サマリー・ページを表示情報セクションまでスクロールし、「アプリの追加」アイコンをクリックします。
3. Oracle Content Managementアイコンを参照して選択します。
4. アイコンで使用する色に合わせてバックグラウンド色を#564162に設定します。
サマリーの確認およびアプリケーション・アイコンの追加が終了したら、「作成」をクリックします。
Slackアプリケーションを組織アプリケーションとしてインストールする場合は、「エンタープライズ組織アプリとして有効化」をチェックする必要がある場合があります。
インストール・ボタンをクリックしてアプリケーションをインストールし、OAuthトークンを生成します。

Oracle Content Managementへのアプリケーション資格証明の追加

Oracle Content Managementに必要なすべての資格証明が生成されると、構成に追加する必要があります。

クライアントID、クライアント・シークレット、署名シークレットおよびボット・ユーザーのOAuthトークンの値を、Slack情報ページのアプリケーションから、Oracle Content ManagementのSlack構成ダイアログとの統合の2ページ目の適切なフィールドにコピーします。
終了したら、「保存」をクリックします。
オプションで、「Slack内のコンテンツ・プレビューを表示」を有効にします。このオプションを使用すると、Slackユーザーがコンテンツを表示する権限を持っている場合、Slackで使用されるリンクでOracle Content Management内のコンテンツのプレビュー・イメージを表示できます。

ノート:

Slack用のアプリケーションを特定のワークスペースにインストールし、構成が終了した場合、アプリケーションにアクセスする必要があるすべてのユーザーは、SlackのSlackアプリケーション・ディレクトリを使用してSlackクライアントに接続する必要があります。