Mattermostの統合機能、APIメモ

やったこと

mattermostで何ができるのか調べてみた。

できること

  • 内向きのウェブフック
    • POSTすると指定したチャンネルに投稿できる。
  • 外向きのウェブフック
    • 特定の単語にマッチするときに、指定したURLにHTTP POSTする。
  • スラッシュコマンド
    • スラッシュコマンドを入力すると、指定したURLにHTTP POST/GETする。
  • API
    • mattermostのWeb API。ユーザー、チーム、チャンネル等の新規作成、更新、削除等ができる。

誰が使えるの?

機能 システム管理者 チーム管理者 メンバー
内向きのウェブフック 設定次第で可
外向きのウェブフック 設定次第で可
スラッシュコマンド 設定次第で可
API

「設定次第で可」は、「統合機能の管理を管理者のみに制限する」設定を無効にする。

APIの認証方法

  • /api/v4/users/loginにIDとパスワードをPOST
    • POSTとするとAPIアクセス用のトークンが返ってくる。それを使ってAPIを使う。
  • パーソナルアクセストークンを使う
    • APIにアクセスするときに、パーソナルアクセストークンを付与する。
    • 「パーソナルアクセストークンを有効にする」を有効にして、ユーザーごとにトークンを発行する。

ウェブフック、スラッシュコマンドを使うときは、config.jsonAllowedUntrustedInternalConnectionsにアクセスを許可するIPアドレスの範囲を指定する。192.168.56.0/24みたいに。