Zoom

A1Connection architecture

The connection uses OAuth 2.0 against the vendor's own consent screen. The authorisation request names the minimum scopes the features need — the exact scope list is shown in the security-flow panel below, pulled from the same provider registry the application uses. The code-for-token exchange happens entirely server-side (HTTP Basic クライアント認証, per the vendor's token endpoint contract); tokens are stored encrypted at rest and are never rendered back to any screen — connection pages show presence, not values.

トークンのライフサイクルは単一のチェックポイントで管理されます。有効期限が切れると自動更新がトリガーされ、ローテーションされたリフレッシュトークンは永続化され、ベンダーによって拒否された更新は目に見える再接続プロンプトとして表示されます（機能が何の説明もなく停止することはありません）。取り消しはどちら側からでも実行可能です。ここから切断するか、ベンダー固有のセキュリティ設定で取り消すことができます。

A2セマンティクスとデータフローの記述

すべてのデータ移動は、結果がログに記録される明示的なアクションです。書き込みはクリック時、またはルールを有効にした場合にのみ自動で実行されます（採用時の自動プッシュはプロバイダーごとにデフォルトで無効になっています）。読み取り（候補者、アカウント、ファイルのインポート）は「インポート」を押したときに実行され、既存データ（クライアントは名前、候補者はメールアドレス）と重複排除され、上書きではなくスキップされ、作成数とスキップ数が正確にレポートされるため、インポートの再実行は設計上安全です。

各アクションはアプリのアクティビティジャーナル（ats_app_activity）に1行書き込まれます。実行内容、日時、対象レコード、そして結果（障害発生時のベンダー自身のエラーテキストをそのまま含む）が記録されます。ATS内の利用状況レポートはこのジャーナルを集計するため、連携レポートと連携の実態が乖離することはありません。

通知の一斉送信、Webhook配信、アクティビティログの記録、メール送信など、リクエストパスから外れる処理はすべて非同期のバックグラウンドスレッドで実行されます。外部エンドポイントの応答が遅くてもインターフェースがフリーズすることはなく、失敗した副作用はログに記録され、不整合を引き起こすようなサイレントな再試行は行われません。

A3運用上の考慮事項

連携は組織レベルで管理され、オーナーおよび管理者ロールに制限されています。採用担当者は連携によって有効化された機能を使用できますが、接続、切断、再設定を行うことはできません。切断すると、保存されていた認証情報は直ちに削除され、依存する機能はサイレントではなく明確に停止します。すでにインポートされたデータは保持され、編集も可能です。

インポートされた人材はインポート済みとしてマークされ、厳格なプライバシーのデフォルト設定が適用されます。応募フォームに入力していない人物については同意を得たとはみなされず、データ保持のデフォルト設定が適用されます。 記録されたすべてのデータはお客様のものです。CSVエクスポートとData Exportアプリは、製品自体が読み取るのと同じデータストアを対象としています。データの取り出しは取り込みと同様に自由に行えるよう設計されており、これは妥協ではなく意図された仕様です。

A4連携トポロジーにおける位置付け

この連携機能は現在レジストリで利用可能です。 One connection per provider unlocks every feature it powers, and the topology grid below shows the neighbouring connectors in the same capability area — statuses come from the same registry that drives the in-app hub, so this page can never claim more than the product does. For anything the catalogue does not cover, Webhooks and Zapier are the generic, documented escape hatch.