--- id: SCR-PFM-INT-006 title: Connection detail route: '/console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}' surface: console product_area: platform module: integrations revision: 1 status: draft design_intent: confirmed implementation_evidence: observed origin: >- docs/milestones/INTG-M1-find-install-connect.md#Decisions D4, D6, D7, D9; docs/milestones/INTG-M2-calls-through-the-gateway.md#Decisions M2-D1, M2-D1a, M2-D1b, M2-D1c, M2-D9 inference: [] source_sha: react-console: baf6dae382d6f41dce976c7f848667ccc37e076f services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1 purpose: 'Inspect a linked provider account and manage its credentials, health and dependent configuration.' supports: - JNY-PFM-INT-001 - JNY-PFM-INT-002 - JNY-PFM-INT-003 - CAP-PFM-INT-004 - CAP-PFM-INT-005 - CAP-PFM-INT-006 - CAP-PFM-INT-012 - CAP-PFM-INT-013 permission: platform.integrations.read entry_from: - '/console/{tenantId}/configuration/platform/integrations/{integrationKey}' - '/console/{tenantId}/configuration/platform/integrations/needs-attention' exits_to: - >- /console/{tenantId}/configuration/platform/integrations/{integrationKey}/connections/{connectionId}/executions - '/console/{tenantId}/configuration/platform/integrations/bindings' - '/console/{tenantId}/configuration/platform/integrations/{integrationKey}' displays: - field: 'Health, figures and state' source: getIntegrationConnection - field: 'Account, verified features and environment' source: getIntegrationConnection - field: Credential facts source: getIntegrationConnectionCredential - field: Bindings that use it source: listIntegrationBindings - field: 'Webhook endpoints, and a manual endpoint’s secret once for managers' source: listIntegrationWebhookEndpoints - field: Connector notices source: getIntegrationConnection (notices) - field: History source: listIntegrationAuditEvents - field: Recent calls source: listIntegrationExecutions actions: - label: Edit operation_id: updateIntegrationConnection permission: platform.integrations.manage confirm: false - label: Verify Now operation_id: verifyIntegrationConnection permission: platform.integrations.manage confirm: false - label: Check Health operation_id: checkIntegrationConnectionHealth permission: platform.integrations.manage confirm: false - label: Replace Credential operation_id: putIntegrationConnectionCredential permission: 'Console control: platform.integrations.manage; API: platform.integration-credentials.manage' confirm: false - label: Re-authorize operation_id: reauthorizeIntegrationConnection permission: 'Console control: platform.integrations.manage; API: platform.integration-credentials.manage' confirm: false - label: Suspend operation_id: suspendIntegrationConnection permission: platform.integrations.manage confirm: true - label: Resume operation_id: resumeIntegrationConnection permission: platform.integrations.manage confirm: true - label: Update Version operation_id: updateIntegrationConnectionVersion permission: platform.integrations.manage confirm: true - label: Rotate Secret operation_id: rotateIntegrationWebhookEndpoint permission: platform.integrations.manage confirm: false - label: Move these bindings to… operation_id: moveIntegrationConnectionBindings permission: platform.integrations.manage confirm: true - label: Disconnect operation_id: disconnectIntegrationConnection permission: platform.integrations.manage confirm: true - label: Try a call operation_id: tryIntegrationConnectionCall permission: platform.integrations.manage confirm: false states: - loading - error - read-only - inactive validation: - BR-CAP-PFM-INT-004-06 - BR-CAP-PFM-INT-004-07 - BR-CAP-PFM-INT-004-08 - BR-CAP-PFM-INT-004-10 - BR-CAP-PFM-INT-005-01 - BR-CAP-PFM-INT-005-10 - BR-CAP-PFM-INT-007-08 - BR-CAP-PFM-INT-012-01 - BR-CAP-PFM-INT-012-07 - BR-CAP-PFM-INT-013-06 patterns: - LibraryPage with breadcrumb navigation. - 'ReadState, Empty and shared error presentation for data reads.' - The Library access boundary controls entry; each action retains its implemented permission gate. - Sectioned detail with Dialog controls for consequential lifecycle changes. component: components/integrations/connection-detail.tsx evidence: - >- react-console at baf6dae3: components/integrations/connection-detail.tsx, connection-facts.tsx, connection-notices.tsx, try-a-call.tsx; lib/integrations/move-bindings.ts, try-a-call.ts controls: [TC-AVL-001, TC-AVL-004, TC-AVL-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-CRY-001, TC-CRY-002, TC-CRY-003, TC-CRY-004, TC-DAT-001, TC-DAT-002, TC-DAT-003, TC-DAT-004, TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-IAM-006, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-MON-001, TC-MON-002, TC-PI-001, TC-PI-002, TC-PI-003, TC-PI-004, TC-PI-005, TC-PRV-001, TC-PRV-002, TC-SEC-001, TC-SEC-002, TC-SEC-003, TC-SEC-004, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-VEN-001, TC-VEN-002, TC-VEN-003] --- # Connection detail ## What the Screen Is For Inspect a linked provider account and manage its credentials, health and dependent configuration. ## What It Shows and Lets People Do Sections expose verified account features, environment, non-secret credential facts, endpoints, notices, dependent bindings, audit history and recent calls. Credential controls are shown under integration management although their API requires credential management. A test-call section is limited to managers viewing usable accounts declared as test accounts. ## States and Errors The Library rejects entry without its read authority. Shared loading and error presentation handles data reads; mutation controls are gated separately. A visible control can still be refused by the API’s independent authorization or lifecycle validation. ## Patterns It Must Respect LibraryPage with breadcrumb navigation. ReadState, Empty and shared error presentation for data reads. The Library access boundary controls entry; each action retains its implemented permission gate. Sectioned detail with Dialog controls for consequential lifecycle changes.