Keycloak

설치

개요

Keycloak은 내장 OAuth2 제공자로 작동합니다. Keycloak에 대한 새로운 네이티브 제공자가 필요하지 않습니다. Keycloak 클라이언트를 OpenID Connect 클라이언트로 구성하고 provider: 'oauth2' 안정적인 providerId예를 들어 keycloak.

Keycloak 클라이언트 설정

인증 Capacitor 흐름을 사용하세요.

Use the authorization code flow.
Section titled “Keycloak client settings”
애플리케이션에서 사용하는 모든 리다이렉트 URI를 등록하세요. 예를 들어 myapp://oauth/keycloak 모바일과 HTTPS callback URL을 프로덕션 웹에 사용하세요.
scopes를 사용하세요. 예를 들어 openid profile email. Add offline_access 만 사용하세요.

issuer URL은 배포에 따라 다릅니다. 현재 Keycloak 배포에서는 realm 메타데이터를 https://keycloak.example.com/realms/my-realm/.well-known/openid-configuration에 공개하고 있습니다. 그러나 일부 배포에서는 추가적인 base path를 포함할 수 있습니다. realm의 OpenID Endpoint Configuration에서 issuer URL을 확인하세요.

OIDC discovery 예제

Prefer issuerUrl 클립보드에 복사

import { SocialLogin } from '@capgo/capacitor-social-login';

const keycloakIssuer = 'https://keycloak.example.com/realms/my-realm';

await SocialLogin.initialize({
  oauth2: {
    keycloak: {
      appId: 'your-keycloak-client-id',
      issuerUrl: keycloakIssuer,
      redirectUrl: 'myapp://oauth/keycloak',
      scope: 'openid profile email',
      pkceEnabled: true,
      resourceUrl: `${keycloakIssuer}/protocol/openid-connect/userinfo`,
    },
  },
});

const result = await SocialLogin.login({
  provider: 'oauth2',
  options: {
    providerId: 'keycloak',
  },
});

console.log(result.result.idToken);
console.log(result.result.accessToken?.token);
console.log(result.result.resourceData);

리프레시 토큰을 위해 요청하세요. offline_access 만약 Keycloak의 도메인과 클라이언트가 이 앱에 대해 리프레시 토큰을 허용한다면:

await SocialLogin.initialize({
  oauth2: {
    keycloak: {
      appId: 'your-keycloak-client-id',
      issuerUrl: keycloakIssuer,
      redirectUrl: 'myapp://oauth/keycloak',
      scope: 'openid profile email offline_access',
      pkceEnabled: true,
    },
  },
});

컨텍스트: Capgo 마케팅 웹사이트. 역할: UI 레이블. 위치: 페이지 agent/[slug].astro. 메시지 키 `agents_page_copy_label` (Agent 페이지 복사 레이블).

수동 엔드포인트 fallback 섹션

const keycloakRealmUrl = 'https://keycloak.example.com/realms/my-realm';

await SocialLogin.initialize({
  oauth2: {
    keycloak: {
      appId: 'your-keycloak-client-id',
      authorizationBaseUrl: `${keycloakRealmUrl}/protocol/openid-connect/auth`,
      accessTokenEndpoint: `${keycloakRealmUrl}/protocol/openid-connect/token`,
      redirectUrl: 'myapp://oauth/keycloak',
      scope: 'openid profile email',
      pkceEnabled: true,
      resourceUrl: `${keycloakRealmUrl}/protocol/openid-connect/userinfo`,
      logoutUrl: `${keycloakRealmUrl}/protocol/openid-connect/logout`,
    },
  },
});

OIDC 디스커버리가 차단되거나 앱에 메타데이터를 노출하지 않는 경우, 엔드포인트를 직접 구성하세요. Base URL은 Keycloak 배포가 공개하는 것과 정확히 일치해야 합니다:

인증 연결 preset 제공자 ID 중 하나가 아닙니다. 이미 SocialLoginAuthConnect을 사용하고 있다면, oauth2 을 초기화하고 로그인할 수 있습니다. provider: 'oauth2' 더보기 providerId: 'keycloak'.

자세히 보기 Keycloak OpenID Connect 엔드포인트 참조 발견 및 엔드포인트 경로를 위한.

Keycloak에서 계속 진행

Keycloak을 사용 중이라면 Keycloak 인증 및 계정 흐름을 계획하고 계정에 연결하기 위해 Capgo에서 @capgo/capacitor-social-login을 사용합니다. Using @capgo/capacitor-social-login Using @capgo/capacitor-social-login Using @capgo/capacitor-passkey Using @capgo/capacitor-passkey Using @capgo/capacitor-native-biometric @capgo/capacitor-native-생체인증 for capgo 구현 세부 사항에 대한 @capacitor-native-biometric 구현에 대한 인증 및 계정 흐름을 계획하고 계정에 연결하기 위해 Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-social-login