Slack
目次
概要サービス仕様ユーザー管理グループ / チャンネル管理コネクタ仕様業務アセットの作成アカウント管理アカウントの作成アカウントの削除(無効化)同期する項目(アカウントのマッピング)指定可能な key と意味
概要
Slack は、チームのコミュニケーションを支えるビジネス向けメッセージングプラットフォームです。チャンネルでの会話、ユーザー管理、ユーザーグループ、チャンネルへの参加管理などの機能を提供します。
| 公式HP | https://slack.com/intl/ja-jp/ |
|---|---|
| 公式ヘルプ | https://slack.com/intl/ja-jp/help |
| APIドキュメント | https://api.slack.com/ |
サービス仕様
Slack は以下の主要な機能と仕様を提供します。
ユーザー管理
- ユーザーの招待(作成) / 有効化・無効化(削除に相当する運用) / 属性更新
- ユーザー種別(通常メンバー / ゲスト等)は Slack 側の仕様・プランに依存します
グループ / チャンネル管理
- ユーザーグループ(User Group)へのメンバー追加・削除
- チャンネルへの参加(Join / Invite)
- 一般にパブリックチャンネルは扱いやすい一方、プライベートチャンネルは Slack 側の権限・プラン制約に依存します
コネクタ仕様
| 項目 | 備考 |
|---|---|
| アカウント管理 | • アカウントの作成 / 有効化・無効化(削除に相当) • 属性同期による属性更新 |
| グループ、チャンネルの管理 | 割当種別で設定できます(ユーザーグループ / チャンネル) |
指定可能な key と意味
以下は、アカウント作成 / 属性同期で利用できる代表的なマッピング項目です(詳細は Slack 側仕様に依存します)。
| 指定可能key | 必須 | 説明 | 式の記述例 | デフォルトの式 | 公式ドキュメントのProfile Attribute | 公式ドキュメントのSCIM Attribute | 備考 |
|---|---|---|---|---|---|---|---|
| userName | ✅ | ユーザー名。一意。最大 21 文字。ピリオドアンダースコア、ハイフンをサポート。その他はアンダースコアに変換。 | Username | userName | |||
| name.givenName | 名 | name | |||||
| name.familyName | 姓 | name | |||||
| nickName | ニックネーム | Nickname | nickName | ||||
| displayName | 最大 80 文字。ピリオドアンダースコア、ハイフンをサポート。その他はアンダースコアに変換。 | Display Name | displayName, userName | ||||
| emails[0].value | ✅ | メールアドレス | emails[0]['value'] | ||||
| emails[0].primary | メールアドレスがプライマリーかどうか(設定メールアドレスが一つの場合は強制的に ) | ||||||
| profileUrl | プロファイルURL。URL形式で入力しないとSlackのデフォルトのURLになる。 | "https://yesod.co/" | Profile URL | profileUrl | |||
| photos[0].value | アクセス可能な URL または画像データを含むデータ URL(例:) | "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA..." | Profile Photo | photos[0]['values'] | |||
| title | 役職など | Title | title | ||||
| timezone | タイムゾーン | "Asia/Tokyo" | Timezone | timezone | |||
| addresses[0].locality | 住所 | City | addresses[primary]['locality'] | ||||
| extension.costCenter | コストセンター | Cost Center | enterprise.costCenter | ||||
| addresses[0].country | 国 | Country | addresses[primary]['country'] | ||||
| extension.department | 部署 | Department | enterprise.department | ||||
| extension.division | 部署 | Division | enterprise.division | ||||
| extension.employeeNumber | 従業員番号 | Employee ID | enterprise.employeeNumber | ||||
| name.honorificPrefix | 敬称 | Honorific Prefix | name.honorificPrefix | ||||
| locale | 地域 | Locale | locale | ||||
| extension.manager.managerId | マネージャーID:他のアカウントのID(例:)を指定する。有効なIDでない場合は Null が入る。 | Manager | enterprise.manager.managerId | ||||
| extension.organization | 組織 | Organization | enterprise.organization | ||||
| phoneNumbers[0].value | 電話(携帯電話 の指定方法は Slack 側仕様に依存) | Phone | phoneNumbers[0]['values'] | ||||
| preferredLanguage | ユーザーの言語 | Preferred Language | preferredLanguage | ||||
| roles[0].value | 役割 | Roles | roles | ||||
| userType | 従業員タイプ | UserType | userType | ||||
| addresses[0].postalCode | 郵便番号 | Zip Code | addresses[primary]['postalCode'] |