1. Oracle Integration Generation 2でのSlackアダプタの使用
  2. Slackアダプタ接続の作成
  3. 接続の作成の前提条件
機械翻訳について

接続の作成の前提条件

「Slackアダプタ」で接続を作成するには、次の前提条件を満たす必要があります。

Slack開発者アカウントへのサインアップ

Slack PlatformおよびOracle Integrationを使用してアプリケーションを統合、拡張および構築するには、Slack開発者アカウントが必要です。

アカウントを作成するには、Slack開発者webサイト(https://developer.slack.com)にアクセスし、「サインアップ」をクリックして、画面に表示されるステップに従います。

アカウントを取得した後、用語およびドキュメントのレビューを忘れないでください。

OAuthアプリケーションの作成

Slack APIを安全に実行するための適切なアクセス・トークンを取得するために、「Slackアダプタ」ではSlack OAuth 2.0認証および認可フレームワークを使用します。

SlackでサポートされるOAuth 2.0については、Slackのwebサイトにある次のドキュメントを参照してください:

https://api.slack.com/docs/oauth

Slackプラットフォーム上でOAuthアプリケーションを作成し、この認証ルートを有効にするには:

  1. https://api.slack.comのSlack開発者コンソールにサインインします。
  2. Slack APIタイトル・バーで、「アプリケーション」をクリックして、作成したアプリケーションを表示します。
  3. 「新しいアプリケーションを作成」をクリックします。
    1. アプリケーションの名前を入力します。
    2. このアプリケーションが属するワークスペースを選択します。 選択したワークスペースにアプリケーションが属していることに注意してください。 ワークスペースを閉じると、アプリケーションを管理する能力が削除されます。 この値は後で変更できないため、ワークスペースを慎重に選択してください。
    3. 「アプリケーションの作成」をクリックします。
  4. オプションで、OAuthアプリケーションに関する詳細を追加する場合は、「表示情報」セクションまでスクロールして情報を入力します。
  5. 左側のナビゲーション・メニューの「機能」で、「OAuth &権限」を選択します。
  6. OAuth &の権限ページで、「リダイレクトURL」セクションまでスクロールします。
  7. 「新規リダイレクトURLの追加」をクリックし、Oracle IntegrationインスタンスのコールバックURLを入力します。 たとえば: 
    your_instance_URL:443/icsapis/agent/oauth/callback
  8. 「追加」をクリックし、「URLの保存」をクリックします。
  9. 「スコープ」セクションまでスクロールします。
  10. 「ユーザー・トークンのスコープ」の下で、「OAuthスコープの追加」をクリックします。
  11. このアプリケーションにアクセスするスコープを追加します。 これらのスコープは、「Slackアダプタ」でサポートされる操作に対応します。

    有効なスコープは次のとおりです:

    • channels:read
    • channels:write
    • chat:write:user
    • files:read
    • files:write
    • ファイル:書込み:ユーザー
    • identity.basic
    • search:read
    • users:read
    • users:read.email
  12. [Enter]を押します。

これでOAuthアプリケーションが構成され、使用する準備ができました。 Oracle Integrationと連携して使用するSlackワークスペースにOAuthアプリケーションをインストールする必要があります。

クライアントIDおよびシークレットの取得

OAuthアプリケーションが正常に作成されると、SlackによってクライアントIDとクライアント・シークレットが自動的に生成されます。 これらの資格証明を使用すると、アプリケーションからSlack APIにアクセスできます。

クライアント値を取得するには:
  1. Slack Developerコンソールにサインインします。
  2. 作成したOAuthアプリケーションを開きます。
  3. Slack APIのナビゲーション・ペインで、「基本情報」を選択します。
  4. 「アプリケーション資格証明」セクションにスクロールします。
  5. クライアントIDおよびクライアント・シークレットの値をコピーします。 コピーするクライアント・シークレットを選択する前に、「表示」をクリックしてクライアント・シークレットを確認します。 Oracle Integrationで接続のセキュリティを構成する場合は、資格証明ダイアログでクライアントIDとクライアント・シークレットを入力する必要があります。