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 の仕様上、ゲストを招待するときには、ゲストの種類・最初に参加するワークスペース・最初に参加するチャンネルの指定が必須です。この3つを業務アセットごとに設定します。いずれも必須項目です。
| 項目名 | 設定する値 | 例 |
|---|---|---|
| 招待時のデフォルトワークスペースID | ゲストが最初に参加するワークスペースのID | |
| 招待時のデフォルトチャンネルID | ゲストが最初に参加するチャンネルのID。マルチチャンネルゲストの場合は、カンマ区切りで複数指定できます | |
| ゲストの種類 ※"multi" または "single"を指定してください | (マルチチャンネルゲスト)または (シングルチャンネルゲスト) |
- 3つの項目は属性式として評価されます。固定値を指定する場合は、値を (ダブルクォーテーション)で囲んでください。メンバーの属性に応じて値を変える場合は、属性式を指定できます。
- シングルチャンネルゲストの場合、デフォルトチャンネルIDは1つだけ指定してください。2つ以上指定すると、アカウント作成タスクがエラーになります。
必要な権限
接続時にサインインする Slack アカウントは、Enterprise Grid の組織オーナーまたは組織管理者である必要があります。接続時に、以下のスコープを YESOD に付与します。
| スコープ | 用途 |
|---|---|
| アカウントの更新・無効化 | |
| / | 組織のユーザーの取得、ゲストの招待、ワークスペースへの追加・削除 |
| 組織のワークスペース一覧の取得 | |
| / | ユーザー情報・メールアドレスの取得 |
アカウント管理
取り込み対象
組織内の有効なゲスト(マルチチャンネルゲスト・シングルチャンネルゲスト)を取り込みます。通常メンバー、ボット、無効化されたユーザーは取り込みません。
最終ログイン日時には、Slack の「最終アクティブ日時」が入ります。
アカウントの作成(招待)
Slack の仕様により、ゲストのアカウント作成は招待として行われます。招待されたゲストに招待メールが届き、ゲスト本人が手続きを完了すると利用できるようになります。
招待を受けたゲストが手続きを完了するまでは、ワークスペースの割当付与タスクがエラーになります。手続きの完了後に、タスクを再実行してください。
Slack 上に同じメールアドレスのアカウントがあるかどうかで、動作が変わります。
| Slack 上のアカウントの状態 | ゲストの種類が の場合 | ゲストの種類が の場合 |
|---|---|---|
| 存在しない | 招待時の設定でゲストとして招待します | 招待時の設定でゲストとして招待します |
| 通常メンバーとして存在する | マルチチャンネルゲストに変更して、情報を更新します | エラーになります |
| マルチチャンネルゲストとして存在する | 情報を更新します | エラーになります |
| シングルチャンネルゲストとして存在する | エラーになります | 情報を更新します |
パスワードは設定できません。ゲスト本人が、招待メールからの手続きの中で設定します。パスワードのリセットにも対応していません。
アカウントの削除
アカウント削除タスクでは、Slack 上のアカウントを無効化します。完全には削除しません。Slack 上ですでに削除されているアカウントの場合は、タスクは成功になります。
通常の Slack 業務アセットとの関係
Enterprise Grid では、アカウントの作成・削除は組織(Org)単位でしか行えません。そのため、通常の「Slack」の業務アセットでアカウントの作成・削除・属性同期を行うと、エラーになります。
通常の「Slack」の業務アセットでは、以下の設定をオフにしてください。
- 「アカウント作成タスク・アカウント削除タスクの生成有無」を「アカウント作成タスク・アカウント削除タスクを生成しない」にする
- 「「同期する項目」の値の反映を有効にする」をオフにする
この業務アセットでアカウントを作成すると、通常の「Slack」の業務アセットにもアカウント情報が登録されます。これにより、通常の「Slack」の業務アセットでチャンネル等の割当付与タスクを実行できます。アカウントを削除した場合も、通常の「Slack」の業務アセットからアカウント情報が削除されます。
一括実行時のタスクの順序
Slack 関連の業務アセットのタスクは、互いに依存しています。実行予定日と対象メンバーが同じ場合、以下の順序で実行されます。
| タスク | 実行順序 |
|---|---|
| ゲストのアカウント作成 | 通常メンバーのアカウント削除の後に実行します(通常メンバーからゲストへの切り替え) |
| 通常メンバーのアカウント作成 | ゲストのアカウント削除の後に実行します(ゲストから通常メンバーへの切り替え) |
| 通常の Slack 業務アセットの割当付与(チャンネル等) | Enterprise Grid のアカウント作成・ワークスペースの割当付与の後に実行します |
| Enterprise Grid のアカウント削除・ワークスペースの割当剥奪 | 通常の Slack 業務アセットの割当剥奪(チャンネル等)の後に実行します |