Okta Workflows 用 Miro コネクターを使用すれば、Miro で反復的かつマルチステップな管理タスクを簡単に自動化できるようになります。ワークフローの自動化を設定し、チームとユーザーの管理を簡素化する方法を学びましょう。
対象プラン:Enterprise プラン
Miro ユーザー管理コネクター
Miro ユーザー管理コネクターを使用し、SCIM を有効にした Miro の Enterprises プランの顧客は、組織にユーザーを追加し、ユーザーのライセンスやステータスを管理することができます。
Miro ユーザー管理コネクターを認証する:
Miro ユーザー管理カードを初めてフローに追加する際に、組織との接続を設定するよう要求されます。詳細は、認証の項/span>をご覧ください。
Miro ユーザー管理コネクター アクションカード:
アクション | 説明 |
ユーザーを作成する | 新しいユーザーを作成する。 |
ユーザーを読み込む | 組織内の既存ユーザーをメールアドレスで検索する。 |
ユーザーのライセンスタイプをフルにアップグレードする | 既存のユーザーリソースを更新し、ユーザーのライセンスタイプをフルに変更する。 |
ユーザーステータスを更新する | Miro User Management コネクタは SCIM トークンを使用して動作します 。Miro ユーザー管理は、SSO と SCIM が有効な企業でのみ使用できます。 |
認証
複数の接続は 接続ページから複数の接続を作成および管理できます。
これは、複数の組織で活動する予定がある場合に便利です。Miro ユーザー管理コネクターの各接続は/span>、Miro 組織を 1 つだけ指すことができます。
SCIMを有効にして新しいトークンを取得する、または既存のトークンをコピーするには、以下の手順に従ってください。 SCIMを有効にする方法.
アクションカードから新しい接続を作成する方法:
- [新規接続] をクリックします。
- 接続名(ニックネーム)を入力します。組織を表すような名前を付けることをお勧めします。
-
この手順に従って、Miro の Enterprise インテグレーション ページから、SCIM プロビジョニングを有効にします。
- Miro からベース URL をコピーし、接続セクションのベース URL フィールドに貼り付けます
- Miro から Api トークンをコピーし、接続セクションの アクセストークン フィールドに貼り付けます
- [作成] をクリックします。接続が保存され、フローに戻ります。
ユーザーを作成する
組織内のユーザーを作成します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
ユーザー詳細 | |||
メールアドレス | ユーザーのメールアドレス。 | 文字列 | TRUE |
アクティブ |
ユーザーのステータス。
指定しない場合のデフォルト値は False。 |
ドロップダウン | FALSE |
ユーザーライセンスタイプ |
ユーザーのライセンスタイプ。
指定しない場合、ユーザーのライセンスタイプは、組織のプランに依存するという、Miro の内部ロジックに従って設定される。 |
ドロップダウン | FALSE |
役割 |
組織内でのユーザーの役割。
指定しない場合のデフォルト値は組織メンバー。 |
ドロップダウン | FALSE |
名前 | |||
姓 | ユーザーの姓。 | 文字列 | FALSE |
名 | ユーザーの名。 | 文字列 | FALSE |
表示名 | Miro で表示される名前。 | 文字列 | FALSE |
出力データ
フィールド | 定義 | 種類 |
ユーザー | ||
ユーザー ID | 新ユーザーの ID。 | 文字列 |
ユーザーを読み込む
組織内の既存ユーザーをメールアドレスで検索します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
クエリ | |||
メールアドレス | 検索するユーザーのメールアドレス | 文字列 | TRUE |
出力データ
フィールド | 定義 | 種類 |
ユーザー | ||
ユーザー ID | ユーザーの ID。 | 数値 |
ユーザーライセンスタイプ | ユーザーのライセンスタイプ。 | 数値 |
アクティブ |
ユーザーのステータス。
|
数値 |
名前 | ||
ユーザー名 | ユーザーのメールアドレス。 | 数値 |
姓 | ユーザーの姓。 | 数値 |
名 | ユーザーの名。 | 数値 |
表示名 | Miro で表示される名前。 | 数値 |
ユーザーのライセンスタイプをフルにアップグレードする
既存ユーザーのリソースを更新し、ユーザータイプ(ライセンス)をフルに変更します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
ユーザー (can be omittted where applicable) | |||
ユーザー ID | ユーザーの ID。 | 文字列 | TRUE |
出力データ
フィールド | 定義 | 種類 |
応答 | ||
ステータスコード |
要求の HTTP ステータス。
ライセンスの更新に失敗したことを示すコード:
|
数値 |
ユーザーステータスを更新する
既存のユーザーリソースを更新し、そのアクティブステータスを true または false のいずれかの値に変更します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
ユーザー (can be omittted where applicable) | |||
ユーザー ID | ユーザーの ID。 | 文字列 | TRUE |
アクティブ |
ユーザーの新しいステータス。
|
ドロップダウン | TRUE |
出力データ
フィールド | 定義 | 種類 |
応答 | ||
ステータスコード |
要求の HTTP ステータス。
アクティブなステータスの更新に失敗したことを示すコード:
|
数値 |
Miro 管理者コネクター
Miro 管理者コネクターを使用することで、企業顧客はチームを作成し、チームの設定とメンバーを管理することができます。
Miro 管理者コネクターを認証する:
Miro カードを初めてフローに追加する際に、組織との接続を設定するよう要求されます。詳細は、認証の項/span>をご覧ください。
Miro 管理者コネクターのアクションカード:
アクション | 説明 |
チームを作成する | 既存組織で新しいユーザーを作成する。 |
チームを検索する | 組織内の既存チームを検索する。一致した最初の 10 件のレコードが検索結果セットから選択される。 |
チームにメンバーを追加する | 既存チームに新しいメンバーを追加する。 |
チームメンバーの役割を更新する | 既存チームのチームメンバーの役割を更新する。 |
チームの設定を取得する | 既存チームのチームの設定を取得する。 |
チームの共有ポリシーの設定を更新する | 既存チームの共有ポリシーの設定を更新する。 |
チームの招待設定を更新する | 既存チームの招待ポリシーの設定を更新する。 |
チームのコラボレーション設定を更新する | 既存チームのコラボレーション ポリシーの設定を更新する。 |
チームの公開設定を更新する | 既存チームの公開ポリシーの設定を更新する。 |
チームのコピー権限の設定を更新する。 | 既存チームのコピー権限ポリシーの設定を更新する。 |
ユーザーセッションのワイプアウト(ベータ版) | 指定したメールアドレスのすべてのユーザーセッションをワイプします。 |
認証
Miro 管理コネクターは、OAuth API を使用することで機能します。Miro 管理コネクターは、Enterprises プランの顧客のみが利用できます。新しい接続を作成するために、ユーザーは、以下の機能を満たすアプリのインストールに必要な権限を有している必要があります。
複数の接続は 接続ページから複数の接続を作成および管理できます。
これは、複数の組織で活動する予定がある場合に便利です。Miro 管理コネクターの各接続には、Miro 組織を 1 つだけ提示することができます。
アクションカードから新しい接続を作成する方法:
- [新規接続] をクリックします。
- 接続名(ニックネーム)を入力します。組織を表すような名前を付けることをお勧めします。
- こちらの手順に従って、Miro の Enterprise インテグレーション ページから、組織 ID とアクセストークンを取得します。
- [作成] をクリックします。接続が保存され、フローに戻ります。
サポート対象範囲:
- 組織:チーム:書き込み
- 組織:チーム:読み込み
チームを作成する
既存組織でチームを作成します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
= チーム | |||
チーム名 | チームの名前。 | 文字列 | TRUE |
出力データ
フィールド | 定義 | 種類 |
応答 | ||
チーム ID | 新チームの ID。 | 文字列 |
チームの検索
組織内の既存チームを検索する。一致した最初の 10 件のレコードが検索結果セットから選択される。
入力内容
フィールド | 定義 | 種類 | 要求値 |
クエリ | |||
チーム名 | チーム名と一致する単語。チーム名にその単語が含まれるチームが結果セットとして返される。クエリと完全に一致する名前のチームが検索結果の最上位に表示される。 | 文字列 | FALSE |
出力データ
フィールド | 定義 | 種類 |
応答 | ||
チーム | 最初に見つかった 10 チームのリスト。各チームは以下のフィールドを持っている。 | リスト |
チーム ID | チームの ID | 文字列 |
名前 | チームの名前 | 文字列 |
チームにメンバーを追加する
Team チームに新しいメンバーを追加します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
Team | |||
チーム ID | チームの ID。 | 文字列 | TRUE |
メンバー | |||
ユーザーのメールアドレス | チームに追加するユーザーのメールアドレス。 | 文字列 | TRUE |
出力データ
フィールド | 定義 | 種類 |
応答 | ||
メンバー ID | 新しいチームメンバーの ID。 | 文字 |
チームメンバーの役割を更新する
既存チームのチームメンバーの役割を更新します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
Team | |||
チーム ID | チームの ID。 | 文字列 | TRUE |
メンバー | |||
メンバー ID | チームメンバーの ID。 | 文字列 | TRUE |
役割 |
チーム内でのメンバーの新しい役割。
|
ドロップダウン | TRUE |
出力データ
フィールド | 定義 | 種類 |
応答 | ||
メンバー ID | チームメンバーの ID。 | 文字列 |
役割 |
チームメンバーに割り当てられた新しい役割。
|
文字列 |
チームの設定を取得する
既存チームのチームの設定を取得します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
= チーム | |||
チーム ID | チームの ID。 | 文字列 | TRUE |
出力データ
フィールド | 定義 | 種類 |
チーム招待の設定 | ||
招待できるユーザー |
|
文字列 |
外部ユーザーを招待する |
|
文字列 |
チームのコラボレーション設定 | ||
共同所有者の役割 |
|
文字列 |
チームのコピー権限レベルの設定 | ||
コピー権限レベル |
|
文字列 |
コピーのアクセスレベルの制限 |
|
文字列 |
チームの公開設定 | ||
公開 |
|
文字列 |
チームの共有ポリシーの設定 | ||
デフォルトのボードへのアクセス権限 |
|
文字列 |
デフォルトの組織のアクセス権限 |
|
文字列 |
組織での共有
|
|
文字列 |
チームでの共有 |
|
文字列 |
公開リンクによる共有 |
|
文字列 |
ボードをチームに移動する |
|
文字列 |
チームの共有ポリシーの設定を更新する
既存チームの共有ポリシーの設定を更新します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
Team | |||
チーム ID | チームの ID。 | 文字列 | TRUE |
デフォルトのボードへのアクセス権限 |
|
ドロップダウン | FALSE |
デフォルトの組織のアクセス権限 |
|
ドロップダウン | FALSE |
公開リンクによる共有 |
|
ドロップダウン | FALSE |
チームでの共有 |
|
ドロップダウン | FALSE |
組織での共有
|
|
ドロップダウン | FALSE |
ボードをチームに移動する |
|
ドロップダウン | FALSE |
出力データ
フィールド | 定義 | 種類 |
チームの共有ポリシーの設定 | ||
デフォルトのボードへのアクセス権限 |
|
文字列 |
デフォルトの組織のアクセス権限 |
|
文字列 |
組織での共有
|
|
文字列 |
チームでの共有 |
|
文字列 |
公開リンクによる共有 |
|
文字列 |
ボードをチームに移動する |
|
文字列 |
チームの招待設定を更新する
既存チームの招待ポリシーの設定を更新します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
Team | |||
チーム ID | チームの ID。 | 文字列 | TRUE |
外部ユーザーを招待する |
|
ドロップダウン | FALSE |
招待できるユーザー |
|
ドロップダウン | FALSE |
出力データ
フィールド | 定義 | 種類 |
チームの招待設定 | ||
外部ユーザーを招待する |
|
文字列 |
招待できるユーザー |
|
文字列 |
チームのコピー権限の設定を更新する
既存チームのコピー権限ポリシーの設定を更新する。
入力内容
フィールド | 定義 | 種類 | 要求値 |
Team | |||
チーム ID | チームの ID。 | 文字列 | TRUE |
コピー権限レベル |
|
ドロップダウン | FALSE |
コピー権限レベルの制限 |
|
ドロップダウン | FALSE |
出力データ
フィールド | 定義 | 種類 |
チームのコピー権限の設定を更新する | ||
コピー権限レベル |
|
文字列 |
コピー権限レベルの制限 |
|
文字列 |
チームのコラボレーション設定を更新する
既存チームのコラボレーション ポリシーの設定を更新します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
Team | |||
チーム ID | チームのID。 | 文字列 | TRUE |
共同所有者の役割 |
|
ドロップダウン | FALSE |
出力データ
フィールド | 定義 | 種類 |
チームのコラボレーション設定 | ||
共同所有者の役割 |
|
文字列 |
チームの公開設定を更新する
既存チームの公開ポリシーの設定を更新します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
Team | |||
チーム ID | チームの ID。 | 文字列 | TRUE |
公開 |
|
ドロップダウン | FALSE |
出力データ
フィールド | 定義 | 種類 |
チームの公開設定 | ||
公開 |
|
文字列 |
ユーザーセッションの消去
指定したメールアドレスのすべてのユーザーセッションをワイプします。
入力内容
フィールド | 定義 | 種類 | 要求値 |
ユーザー詳細 | |||
メールアドレス | セッションが消去されるユーザーのメールアドレス。 | 文字列 | TRUE |
出力データ
フィールド | 定義 | 種類 |
応答 | ||
ステータスコード |
要求の HTTP ステータス。
ユーザーセッションのワイプアウト更新の失敗を示すコード:
|
数値 |