Slack EnterpriseGrid(通常メンバー用)
概要
Slack Enterprise Grid は、複数のワークスペースを1つの組織(Org)として一元管理できる、大規模組織向けの Slack のプランです。
この記事では、Slack Enterprise Grid の通常メンバーを管理するコネクタの仕様を説明します。ゲスト(マルチチャンネルゲスト・シングルチャンネルゲスト)は、「Slack Enterprise Grid(ゲスト用)」の業務アセットで管理します。
| 公式サイト | Slack Enterprise Grid |
|---|---|
| APIドキュメント | SCIM API(Enterprise Grid) Web API |
Enterprise Grid プランをご契約の場合のみ利用できます。
コネクタ仕様
コネクタでできること
| 項目 | 内容 |
|---|---|
| アカウント管理 | アカウントの作成・削除(無効化)、「同期する項目」による属性の更新 |
| 割当 | ワークスペースへのメンバーの追加・削除 |
グループプッシュ、チャンネル・ユーザーグループの割当には対応していません。これらは通常の「Slack」の業務アセットで行います(この記事の「通常の Slack 業務アセットとの関係」を参照)。
業務アセットの作成
Slack の OAuth 認証で接続します。追加の入力項目はありません。
- 業務アセットの追加で「Slack Enterprise Grid」を選択します。
- [サインイン]をクリックし、Slack Enterprise Grid の組織の管理者権限を持つアカウントでサインインします。
- Slack の画面でアクセスを許可します。
必要な権限
接続時にサインインする Slack アカウントは、Enterprise Grid の組織オーナーまたは組織管理者である必要があります。接続時に、以下のスコープを YESOD に付与します。
| スコープ | 用途 |
|---|---|
| アカウントの作成・更新・無効化 | |
| / | 組織のユーザーの取得、ワークスペースへの追加・削除 |
| 組織のワークスペース一覧の取得 | |
| / | ユーザー情報・メールアドレスの取得 |
アカウント管理
取り込み対象
組織内の有効な通常メンバーを取り込みます。ゲスト、ボット、無効化されたユーザーは取り込みません。
最終ログイン日時には、Slack の「最終アクティブ日時」が入ります。
アカウントの作成
Slack 上に同じメールアドレスのアカウントがあるかどうかで、動作が変わります。
| Slack 上のアカウントの状態 | 動作 |
|---|---|
| 存在しない | 通常メンバーとして新規作成します |
| 通常メンバーとして存在する | アカウントの情報を更新します(無効化されている場合は有効にして更新します) |
| マルチチャンネルゲストとして存在する | 通常メンバーに変更して、情報を更新します |
| シングルチャンネルゲストとして存在し、所属ワークスペースが1つ | 通常メンバーに変更して、情報を更新します |
| シングルチャンネルゲストとして存在し、所属ワークスペースが0または2つ以上 | エラーになります(Slack の仕様上、通常メンバーに変更できません) |
パスワードはアカウントの新規作成時のみ設定されます。既存アカウントのパスワードの更新・リセットには対応していません(Slack の仕様によるものです)。
アカウントの削除
アカウント削除タスクでは、Slack 上のアカウントを無効化します。完全には削除しません。Slack 上ですでに削除されているアカウントの場合は、タスクは成功になります。
通常の Slack 業務アセットとの関係
Enterprise Grid では、アカウントの作成・削除は組織(Org)単位でしか行えません。そのため、通常の「Slack」の業務アセットでアカウントの作成・削除・属性同期を行うと、エラーになります。
通常の「Slack」の業務アセットでは、以下の設定をオフにしてください。
- 「アカウント作成タスク・アカウント削除タスクの生成有無」を「アカウント作成タスク・アカウント削除タスクを生成しない」にする
- 「「同期する項目」の値の反映を有効にする」をオフにする
この業務アセットでアカウントを作成すると、通常の「Slack」の業務アセットにもアカウント情報が登録されます。これにより、通常の「Slack」の業務アセットでチャンネル・ユーザーグループの割当付与タスクを実行できます。アカウントを削除した場合も、通常の「Slack」の業務アセットからアカウント情報が削除されます。
一括実行時のタスクの順序
Slack 関連の業務アセットのタスクは、互いに依存しています。実行予定日と対象メンバーが同じ場合、以下の順序で実行されます。
| タスク | 実行順序 |
|---|---|
| 通常メンバーのアカウント作成 | ゲストのアカウント削除の後に実行します(ゲストから通常メンバーへの切り替え) |
| ゲストのアカウント作成 | 通常メンバーのアカウント削除の後に実行します(通常メンバーからゲストへの切り替え) |
| 通常の Slack 業務アセットの割当付与(チャンネル等) | Enterprise Grid のアカウント作成・ワークスペースの割当付与の後に実行します |
| Enterprise Grid のアカウント削除・ワークスペースの割当剥奪 | 通常の Slack 業務アセットの割当剥奪(チャンネル等)の後に実行します |