Okta Workflows 用 Miro コネクターを使用すれば、反復的かつマルチステップな管理タスクを簡単に自動化できるようになります。ワークフローの自動化を設定し、チームとユーザーの管理を簡素化する方法を学びましょう。
関連プラン:Enterprise プラン
Miro ユーザー管理コネクター
Miro ユーザー管理コネクターを使用し、SCIM を有効にした Miro の Enterprises プランの顧客は、組織にユーザーを追加し、ユーザーのライセンスやステータスを管理することができます。
Miro ユーザー管理コネクターを認証する:
Miro ユーザー管理カードを初めてフローに追加する際に、組織との接続を設定するよう要求されます。詳細は、認証の項をご覧ください。
Miro ユーザー管理コネクター アクションカード:
アクション |
説明 |
ユーザーを作成する |
新しいユーザーを作成する。 |
ユーザーを読み込む |
組織内の既存ユーザーをメールアドレスで検索する。 |
ユーザーのライセンスタイプをフルにアップグレードする |
既存のユーザーリソースを更新し、ユーザーのライセンスタイプをフルに変更する。 |
ユーザーステータスを更新する |
既存のユーザーリソースを更新し、そのアクティブステータスを true または false のいずれかの値に変更する。 |
認証
Miro ユーザー管理コネクターは、SCIM トークンを使用することで機能します。Miro ユーザー管理は、SSO と SCIM が有効な企業でのみ使用できます。
接続ページで、複数の接続を作成したり、管理することができます。
この機能は、複数組織での運用を予定している場合に有効です。Miro ユーザー管理コネクターの各接続は、Miro 組織を 1 つだけ指すことができます。
SCIM を有効にして、新しいトークンを取得するか、既存のトークンをコピーするには、How to enable SCIM(SCIMの有効化手順)に従ってください。
アクションカードから新しい接続を作成するには、以下の手順に従ってください:
- [New Connection](新規接続)をクリックします。
- 接続名(ニックネーム)を入力します。組織を表すような名前を付けることをお勧めします。
- この手順に従って、Miro の Enterprise インテグレーション ページから、SCIM プロビジョニングを有効にします。
- Miro からベース URL をコピーし、接続セクションのベース URL フィールドに貼り付けます
- Miro から Api トークンをコピーし、接続セクションの アクセストークン フィールドに貼り付けます
- [作成] をクリックします。これで接続が保存され、フローに戻ります。
ユーザーを作成する
組織内のユーザーを作成します。
入力内容
フィールド | 定義 | 種類 | 要求値 |
ユーザー詳細 | |||
メールアドレス | ユーザーのメールアドレス。 | 文字列 | 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 つだけ提示することができます。
アクションカードから新しい接続を作成する方法:
- [新規接続] をクリックします。
- 接続名(ニックネーム)を入力します。組織を表すような名前を付けることをお勧めします。
- こちらの手順に従って、Miro の Enterprise インテグレーション ページから、組織 ID とアクセストークンを取得します。
- [作成] をクリックします。接続が保存され、フローに戻ります。
適用範囲:
- 組織:チーム:書き込み
- 組織:チーム:読み込み
チームを作成する
既存組織でチームを作成します。
入力内容
フィールド |
定義 |
種類 |
要求値 |
チーム |
|
|
|
チーム名 |
チームの名前。 |
文字列 |
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 |
出力データ
フィールド |
定義 |
種類 |
チームの公開設定 |
|
|
公開 |
|
文字列 |