Slack EnterpriseGrid(通常メンバー用)

概要

Slack Enterprise Grid は、複数のワークスペースを1つの組織(Org)として一元管理できる、大規模組織向けの Slack のプランです。 この記事では、Slack Enterprise Grid の通常メンバーを管理するコネクタの仕様を説明します。ゲスト(マルチチャンネルゲスト・シングルチャンネルゲスト)は、「Slack Enterprise Grid(ゲスト用)」の業務アセットで管理します。
⚠️
Enterprise Grid プランをご契約の場合のみ利用できます。

コネクタ仕様

コネクタでできること

項目内容
アカウント管理アカウントの作成・削除(無効化)、「同期する項目」による属性の更新
割当ワークスペースへのメンバーの追加・削除
💡
グループプッシュ、チャンネル・ユーザーグループの割当には対応していません。これらは通常の「Slack」の業務アセットで行います(この記事の「通常の Slack 業務アセットとの関係」を参照)。

業務アセットの作成

Slack の OAuth 認証で接続します。追加の入力項目はありません。
  1. 業務アセットの追加で「Slack Enterprise Grid」を選択します。
  1. [サインイン]をクリックし、Slack Enterprise Grid の組織の管理者権限を持つアカウントでサインインします。
  1. Slack の画面でアクセスを許可します。

必要な権限

接続時にサインインする Slack アカウントは、Enterprise Grid の組織オーナーまたは組織管理者である必要があります。接続時に、以下のスコープを YESOD に付与します。
スコープ用途
アカウントの作成・更新・無効化
/ 組織のユーザーの取得、ワークスペースへの追加・削除
組織のワークスペース一覧の取得
/ ユーザー情報・メールアドレスの取得

アカウント管理

取り込み対象

組織内の有効な通常メンバーを取り込みます。ゲスト、ボット、無効化されたユーザーは取り込みません。 最終ログイン日時には、Slack の「最終アクティブ日時」が入ります。

アカウントの作成

Slack 上に同じメールアドレスのアカウントがあるかどうかで、動作が変わります。
Slack 上のアカウントの状態動作
存在しない通常メンバーとして新規作成します
通常メンバーとして存在するアカウントの情報を更新します(無効化されている場合は有効にして更新します)
マルチチャンネルゲストとして存在する通常メンバーに変更して、情報を更新します
シングルチャンネルゲストとして存在し、所属ワークスペースが1つ通常メンバーに変更して、情報を更新します
シングルチャンネルゲストとして存在し、所属ワークスペースが0または2つ以上エラーになります(Slack の仕様上、通常メンバーに変更できません)
💡
パスワードはアカウントの新規作成時のみ設定されます。既存アカウントのパスワードの更新・リセットには対応していません(Slack の仕様によるものです)。

アカウントの削除

アカウント削除タスクでは、Slack 上のアカウントを無効化します。完全には削除しません。Slack 上ですでに削除されているアカウントの場合は、タスクは成功になります。

割当種別

割当種別名タイプ割当項目の例備考
ワークスペースワークスペースA ワークスペースB組織内のワークスペースを取り込みます
  • すでにワークスペースに参加しているアカウントへの割当付与タスクは、成功になります。
  • ワークスペースに参加していないアカウントからの割当剥奪タスクは、成功になります。

同期する項目

初期設定では、以下の項目を同期します。
必須属性名keyデフォルトの式例
✅ユーザー名
✅メールアドレス
メインのメールアドレスか
名
姓
💡
アカウント作成時は、メールアドレスをもとに Slack 上の既存アカウントを確認します。

通常の Slack 業務アセットとの関係

Enterprise Grid では、アカウントの作成・削除は組織(Org)単位でしか行えません。そのため、通常の「Slack」の業務アセットでアカウントの作成・削除・属性同期を行うと、エラーになります。
⚠️
通常の「Slack」の業務アセットでは、以下の設定をオフにしてください。
  • 「アカウント作成タスク・アカウント削除タスクの生成有無」を「アカウント作成タスク・アカウント削除タスクを生成しない」にする
  • 「「同期する項目」の値の反映を有効にする」をオフにする
この業務アセットでアカウントを作成すると、通常の「Slack」の業務アセットにもアカウント情報が登録されます。これにより、通常の「Slack」の業務アセットでチャンネル・ユーザーグループの割当付与タスクを実行できます。アカウントを削除した場合も、通常の「Slack」の業務アセットからアカウント情報が削除されます。

一括実行時のタスクの順序

Slack 関連の業務アセットのタスクは、互いに依存しています。実行予定日と対象メンバーが同じ場合、以下の順序で実行されます。
タスク実行順序
通常メンバーのアカウント作成ゲストのアカウント削除の後に実行します(ゲストから通常メンバーへの切り替え)
ゲストのアカウント作成通常メンバーのアカウント削除の後に実行します(通常メンバーからゲストへの切り替え)
通常の Slack 業務アセットの割当付与(チャンネル等)Enterprise Grid のアカウント作成・ワークスペースの割当付与の後に実行します
Enterprise Grid のアカウント削除・ワークスペースの割当剥奪通常の Slack 業務アセットの割当剥奪(チャンネル等)の後に実行します