Slack

目次

概要

Slack は、チームのコミュニケーションを支えるビジネス向けメッセージングプラットフォームです。チャンネルでの会話、ユーザー管理、ユーザーグループ、チャンネルへの参加管理などの機能を提供します。

サービス仕様

Slack は以下の主要な機能と仕様を提供します。

ユーザー管理

  • ユーザーの招待(作成) / 有効化・無効化(削除に相当する運用) / 属性更新
  • ユーザー種別(通常メンバー / ゲスト等)は Slack 側の仕様・プランに依存します

グループ / チャンネル管理

  • ユーザーグループ(User Group)へのメンバー追加・削除
  • チャンネルへの参加(Join / Invite)
    • 一般にパブリックチャンネルは扱いやすい一方、プライベートチャンネルは Slack 側の権限・プラン制約に依存します

コネクタ仕様

項目備考
アカウント管理 • アカウントの作成 / 有効化・無効化(削除に相当) • 属性同期による属性更新
グループ、チャンネルの管理割当種別で設定できます(ユーザーグループ / チャンネル)

業務アセットの作成

OAuth を利用して接続します。 接続するユーザーは、Slack ワークスペースに対してユーザー管理・割当操作を行える権限を持っている必要があります(必要な権限は Slack のプラン・権限設計に依存します)。
 

アカウント管理

アカウントの作成

Slack では通常、招待(Invite)によってユーザーを作成します。招待の挙動(メール送信、初回ログイン時の入力項目等)は Slack 側の設定に依存します。
 

アカウントの削除(無効化)

運用上は「削除」ではなく「無効化(Deactivation)」として扱うケースがあります。YESOD 側のタスクは Slack 側 API の仕様に従って実行されます。
 

同期する項目(アカウントのマッピング)

Slack は SCIM 2.0 を利用したプロビジョニングに依存します。
 

指定可能な key と意味

以下は、アカウント作成 / 属性同期で利用できる代表的なマッピング項目です(詳細は Slack 側仕様に依存します)。
指定可能key必須説明式の記述例デフォルトの式公式ドキュメントのProfile Attribute公式ドキュメントのSCIM Attribute備考
userNameユーザー名。一意。最大 21 文字。ピリオドアンダースコア、ハイフンをサポート。その他はアンダースコアに変換。UsernameuserName
name.givenNamename
name.familyNamename
nickNameニックネームNicknamenickName
displayName最大 80 文字。ピリオドアンダースコア、ハイフンをサポート。その他はアンダースコアに変換。Display NamedisplayName, userName
emails[0].valueメールアドレスEmailemails[0]['value']
emails[0].primaryメールアドレスがプライマリーかどうか(設定メールアドレスが一つの場合は強制的に
profileUrlプロファイルURL。URL形式で入力しないとSlackのデフォルトのURLになる。"https://yesod.co/"Profile URLprofileUrl
photos[0].valueアクセス可能な URL または画像データを含むデータ URL(例:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA..."Profile Photophotos[0]['values']
title役職などTitletitle
timezoneタイムゾーン"Asia/Tokyo"Timezonetimezone
addresses[0].locality住所Cityaddresses[primary]['locality']
extension.costCenterコストセンターCost Centerenterprise.costCenter
addresses[0].countryCountryaddresses[primary]['country']
extension.department部署Departmententerprise.department
extension.division部署Divisionenterprise.division
extension.employeeNumber従業員番号Employee IDenterprise.employeeNumber
name.honorificPrefix敬称Honorific Prefixname.honorificPrefix
locale地域Localelocale
extension.manager.managerIdマネージャーID:他のアカウントのID(例:)を指定する。有効なIDでない場合は Null が入る。Managerenterprise.manager.managerId
extension.organization組織Organizationenterprise.organization
phoneNumbers[0].value電話(携帯電話 の指定方法は Slack 側仕様に依存)PhonephoneNumbers[0]['values']
preferredLanguageユーザーの言語Preferred LanguagepreferredLanguage
roles[0].value役割Rolesroles
userType従業員タイプUserTypeuserType
addresses[0].postalCode郵便番号Zip Codeaddresses[primary]['postalCode']