接続と管理

コネクターを追加する

Connectors → Add connectors を開きます。カタログ（Catalog）は、インストール済みのメニュー項目とタスクのアクティベーションを分けて管理しています。

1. プロバイダーの横にある + を選択します。
2. プロバイダーと認証ステータスを確認します。
3. 各サービスのパーミッションレベルを選択します。
4. プロバイダーのウィンドウで認証を行います。
5. Minara に戻り、成功状態になるまで待ちます。

接続が成功した後にのみ、Minara はファーストレベルメニューに新しいカタログエントリを追加します。なお、接続前から 6 つのデフォルトエントリは表示されたままです。

サービスアクセスを選択する

各サービスは、対応するレベルを提供しています。

• Off はそのサービスを除外します。
• Read は検索と取得を有効にします。
• Full はサポートされている作成・更新アクションを追加します。

初回接続時はデフォルトで Full になります。これにより、選択したコネクターが公開されているアクションを実行できます。タスクで読み取りのみが必要な場合は、認証前にアクセスを制限してください。すべてのサービスが Off になっている状態では、認証を続行できません。

ゲートウェイは組み込みカタログから OAuth スコープを生成します。未知のサービス ID やクライアントから送信された任意のスコープは拒否されます。

レベルを下げると、Minara のサービスゲートが即座に厳しくなります。一部のプロバイダーでは、すでに認可済みのスコープが保持されることがあります。プロバイダー側でもそれらの過去のスコープを削除したい場合は、切断してから再接続してください。

ファーストレベルメニューとホバーメニューを使う

コネクター ピッカーを開くと、表示されているエントリを確認できます。プロバイダーにカーソルを合わせると、セカンドレベルメニューが開きます。そこから以下の操作が可能です。

• Use in this task のオン / オフを切り替える。
• デフォルトアカウントを選択する。
• 別のアカウントを接続する。
• Manage connector を開く。

シェブロンの横にある緑のドットは、コネクターが接続済みで、現在のタスクに対してアクティブであることを示します。切断中または非アクティブなエントリにはステータスドットが表示されません。

タスクのアクティベーションにより、セッション限定のルーティングオーバーレイが作成されます。オフにすると、現在のタスクからそのコネクターのスキルとツールが削除されます。ただし、プロバイダーアカウントの認可は取り消されません。

複数アカウントを管理する

1 つのコネクターは複数の ID を保持できます。アカウント一覧には、表示名、利用可能な場合はマスクされた識別子、およびデフォルトアカウントが表示されます。

• ID 固有のデータを読み取る前に、1 つのアカウントを選択してください。
• クロスアカウント読み取りを行う前に、アカウントを明示的に選択してください。
• 書き込み操作は必ず 1 つのアカウントに解決してください。
• 期限切れのアカウントは詳細ダイアログから再接続してください。

Minara は、以前のアカウント選択をその後のリスクの高い操作に対する許可として扱うことはありません。

切断または削除する

切断すると、ローカルのコネクター認可が取り消され、現在のタスクからそのツールが削除されます。ファーストレベルメニューのエントリはそのまま残ります。

メニューからエントリを削除するには、次の手順を実行します。

1. そのコネクターのすべてのアカウントを切断します。
2. Add connectors を開きます。
3. コネクターカードのチェックマークを選択します。

いずれかのアカウントが接続されている間は、カタログは削除をブロックします。メニューからエントリを削除しても、その組み込み定義は削除されません。

ルートと配信を確認する

Manage connector では、アカウント、サービスパーミッション、接続ルート、リリース状況、アーティファクトの配信設定を確認できます。プレビュールートは環境によっては利用できない場合があります。その場合、Minara は該当アクションを停止し、理由を表示します。

機能の実装と現在の利用可否は別です。カタログに機能が表示されていても、プロバイダー承認、デプロイ設定、ローカルアダプターが揃うまで Connect が無効な場合があります。現在のビルドではボタンの状態と理由が基準です。