연결 생성

POST /v1/connections · 권한 connections:write

환경에 새 연결을 등록합니다. 프로토콜 설정이 필요한 연결(social, enterprise)은 inactive 상태로 시작합니다. 이후 :activate로 명시적으로 활성화하십시오. enterprise 연결은 active 상태로 생성할 수 없습니다. 새 연결은 아직 성공한 로그인 테스트를 거칠 수 없기 때문입니다. 설정에는 비밀 값을 포함하지 마십시오. 환경당 최대 100개의 연결과 20개의 일반 소셜(oidc_generic, oauth2_generic) 연결을 둘 수 있으며, 조직당 최대 20개의 연결을 둘 수 있습니다.

요청

JSON 본문입니다(알 수 없는 필드는 400 unknown_field로 거부됩니다).

응답

201 Created와 함께 연결 정보 및 버전을 담은 ETag 헤더가 반환됩니다.

{
  "id": "conn_0k3v8m1q2x9dz4h7s5t6w0y1ab",
  "key": "google",
  "type": "social",
  "strategy": "google",
  "name": "Google",
  "display_name": "Sign in with Google",
  "status": "inactive",
  "org_id": null,
  "allowed_email_domains": [],
  "allow_external_domains": false,
  "jit_mode": null,
  "email_trust": null,
  "default_role_ids": [],
  "trust_idp_mfa": null,
  "allow_idp_initiated": null,
  "idp_initiated_default_application_id": null,
  "idp_initiated_allowed_application_ids": [],
  "settings": {},
  "created_at": "2026-10-05T09:30:00.123456Z",
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

패스키 설정

type: "passkey"인 경우 settings 객체는 아래 키만 허용합니다. 그 밖의 키, 잘못된 타입 또는 범위를 벗어난 값은 422 validation_failed와 함께 /settings/max_credentials_per_user 같은 errors[].pointer로 거부됩니다. null 값은 기본값을 의미합니다. 형식 오류는 플랜 오류보다 먼저 보고됩니다.

플랜 제한 키에 기본값이 아닌 값을 쓰면 403 plan_feature_unavailable과 함께 feature 및 required_plan 멤버가 반환됩니다. 플랜 권한을 사용할 수 있게 되기 전까지는 어떤 환경에서도 이 키를 설정할 수 없습니다. 기본값(false, [], null)을 쓰거나 키를 제거하는 것은 언제나 허용됩니다. 기능을 사용할 수 있게 되면 모든 related_origins 항목은 환경의 활성 인증 커스텀 도메인이어야 하며, 그렇지 않으면 요청은 422 related_origin_not_verified로 실패합니다.

오류

예제

curl -X POST https://api.eu.keenauth.com/v1/connections \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key":"google","type":"social","strategy":"google","name":"Google"}'