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