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. 招待時の設定(下表)を入力します。
  1. [サインイン]をクリックし、Slack Enterprise Grid の組織の管理者権限を持つアカウントでサインインします。
  1. Slack の画面でアクセスを許可します。
招待時の設定 Slack の仕様上、ゲストを招待するときには、ゲストの種類・最初に参加するワークスペース・最初に参加するチャンネルの指定が必須です。この3つを業務アセットごとに設定します。いずれも必須項目です。
項目名設定する値例
招待時のデフォルトワークスペースIDゲストが最初に参加するワークスペースのID
招待時のデフォルトチャンネルIDゲストが最初に参加するチャンネルのID。マルチチャンネルゲストの場合は、カンマ区切りで複数指定できます
ゲストの種類 ※"multi" または "single"を指定してください(マルチチャンネルゲスト)または (シングルチャンネルゲスト)
⚠️
  • 3つの項目は属性式として評価されます。固定値を指定する場合は、値を (ダブルクォーテーション)で囲んでください。メンバーの属性に応じて値を変える場合は、属性式を指定できます。
  • シングルチャンネルゲストの場合、デフォルトチャンネルIDは1つだけ指定してください。2つ以上指定すると、アカウント作成タスクがエラーになります。

必要な権限

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

アカウント管理

取り込み対象

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

アカウントの作成(招待)

Slack の仕様により、ゲストのアカウント作成は招待として行われます。招待されたゲストに招待メールが届き、ゲスト本人が手続きを完了すると利用できるようになります。
⚠️
招待を受けたゲストが手続きを完了するまでは、ワークスペースの割当付与タスクがエラーになります。手続きの完了後に、タスクを再実行してください。
Slack 上に同じメールアドレスのアカウントがあるかどうかで、動作が変わります。
Slack 上のアカウントの状態ゲストの種類が の場合ゲストの種類が の場合
存在しない招待時の設定でゲストとして招待します招待時の設定でゲストとして招待します
通常メンバーとして存在するマルチチャンネルゲストに変更して、情報を更新しますエラーになります
マルチチャンネルゲストとして存在する情報を更新しますエラーになります
シングルチャンネルゲストとして存在するエラーになります情報を更新します
💡
パスワードは設定できません。ゲスト本人が、招待メールからの手続きの中で設定します。パスワードのリセットにも対応していません。

アカウントの削除

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

割当種別

割当種別名タイプ割当項目の例備考
ワークスペースワークスペースA ワークスペースB組織内のワークスペースを取り込みます
  • ワークスペースには、現在のゲストの種類(マルチチャンネルゲスト/シングルチャンネルゲスト)のまま追加します。
  • すでにワークスペースに参加しているアカウントへの割当付与タスクは、成功になります。
  • ワークスペースに参加していないアカウントからの割当剥奪タスクは、成功になります。

同期する項目

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

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

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

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

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