Skip to main content

​
Envoy について

Iru は OAuth 2.0（認可コード）を使用して Envoy の API から 訪問者の入館ログ、招待、拠点、従業員 ディレクトリのメタデータを読み取ります。一般的なスコープには entry_logs.read、invites.read、locations.read、employees.read に加え、Iru がログインを繰り返さずにアクセストークンをローテーションできるようにする refresh_tokens が含まれます。

​
仕組み

Iru は Envoy の OAuth 2.0 認可コード フローを使用します。ソースを有効にすると、ブラウザのポップアップ が Envoy の認可サーバーにリダイレクトします。サインインしてスコープを確認し、アクセスを許可すると、Envoy がコードを返し、Iru はそれを アクセストークン と リフレッシュトークン に交換します。 公式リファレンス: デベロッパーハブ、認可、スコープ。

​
前提条件

  • Envoy の 管理者 または Global Admin。
  • ブラウザの ポップアップ が有効になっていること。

​
Envoy を Iru に接続する

適切な管理者が OAuth を完了できるよう、Iru Compliance で Envoy を有効にする前にこのタブの手順を完了してください。
1

Envoy にサインインする

Envoy ダッシュボード（例: dashboard.envoy.com またはワークプレイスで使用している URL）を開き、管理者 または Global Admin 権限でサインインします。
2

Premium または Enterprise の API アクセスを確認する

Envoy のデベロッパー API には、Iru が要求するスコープを利用できるプランが必要です。サブスクリプションがこの記事の 前提条件 を満たしていることを確認してください。
3

OAuth スコープを確認する

同意画面がセキュリティレビューの内容と一致するよう、Envoy の認可 と スコープ に目を通します。
4

Iru のポップアップを許可する

Compliance で使用するブラウザプロファイルで、Envoy の OAuth ウィンドウがブロックされないよう、Iru のホスト名に対して ポップアップ を許可します。
Iru Compliance タブに進んでください。

​
トラブルシューティング

Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
Iru のオリジンに対してポップアップを許可し、再試行してください。
Envoy のロールが不十分です。Admin/Global Admin を使用してください。
標準 プランでは API を利用できない場合があります。Envoy のライセンスに従ってアップグレードしてください。
管理者が無効化されています。有効なアカウントで 再承認 してください。

​
関連記事

Sources の管理

すべての Compliance ソースを参照、管理します。

Compliance を使い始める

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

Artifacts の管理

ソースやアクションから得たエビデンスをアップロード、確認、整理します。