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