コネクター
コネクターは、外部アプリケーションをZoho Mailと連携する際の認証メカニズムとして機能します。これらのコネクターを使用して、eWidget拡張を作成できます。これらの拡張機能は、外部アプリケーションのREST APIを呼び出す仕組みです。そのためには、Zoho Mailに、外部アプリケーションからのAPIとデータへのアクセスを許可する必要があります。
Zoho Mailでコネクターを作成することで、この認証プロセスを実行できます。コネクターに使用されるserviceNameは、拡張の作成時にプラグインマニフェストで使用されます。これにより、必要な認証が行われます。
メモ：
DREコネクターを使用して、外部アプリケーションと連携するための接続を確立することもできます。
サポートされている認証方法
認証モードは、eWidgetに連携するアプリケーションによって異なる場合があります。外部アプリケーションで使用される認証方法を特定し、Zoho Mailのコネクターでサポートされる次の方法のいずれかを選択します。
- APIキー
- OAuth 1.0
- OAuth 2.0
コネクターの設定
次の手順に従って、Developer Spaceで作成する拡張のコネクターを作成します。
- Zoho Mailにサインインしてください。
- ［設定］>［連携］>［Developer Space］の順に移動します。
- 左メニューから［コネクター］を選択します。
- ［接続の作成］をクリックして、設定を開始します。
- ［新しいカスタム接続］画面で、次の情報を入力します。
- サービス名 - プラグインマニフェストで使用するserviceNameを入力します。
- 表示名 - 識別情報の表示名を入力します。
- トークンタイプ - アクセストークンのタイプ。このタイプは、その構成方法を定義します。（ベアラートークン、MACトークンなど）
- 認証タイプ - APIキーとして、OAuth 1.0またはOAuth 2.0のいずれかを選択します。選択した方法に応じて、必要な認証詳細を入力します。
- ［保存］をクリックします。
これで、このコネクターがZoho Mailアカウントに作成されました。
コネクターの使用
コネクターのテスト
作成したコネクターをテストするには、コネクターを認証する必要があります。
- コネクターリストに移動します。
- 複製したいコネクターにカーソルを合わせます。
- ［接続］をクリックします。
- 認証手順を完了して、Zoho Mailに外部アプリケーションデータへのアクセス権を付与します。
これで、コネクターをテストできるようになりました。
拡張でのコネクターの実行
invoke URLコマンドの使用中は、コネクターの作成時に使用されたserviceNameを使用する必要があります。作成した拡張機能をユーザーがインストールする場合、認証手順を完了して、Zoho Mailに外部アプリケーションデータへのアクセスを許可する必要があります。これらの手順は、コネクターによってバックグラウンドで処理されます。