Keycloak

설치

개요

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

Keycloak 클라이언트 설정

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

code
PKCE를 앱 구성에서 활성화 유지하세요.
앱이 사용하는 모든 리다이렉트 URI를 등록하세요. 예를 들어 myapp://oauth/keycloak 모바일과 HTTPS callback URL을 프로덕션 웹에서 사용하세요.
scopes를 사용하세요. openid profile emailrealm과 client가 리프레시 토큰을 발급하는 것을 구성했을 때만 offline_access 정확한 issuer URL은 배포에 따라 다릅니다. 현재 Keycloak 배포에서는 realm 메타데이터를

에서 공유합니다. 그러나 일부 배포에서는 추가 base path를 포함합니다. realm의 OpenID Endpoint Configuration에서 issuer URL을 사용하세요. https://keycloak.example.com/realms/my-realm/.well-known/openid-configurationOIDC discovery 예시

OIDC discovery 예시

이러한 방식으로 플러그인을 사용하여 realm 메타데이터에서 인증, 토큰, 로그아웃 엔드포인트를 자동으로 발견할 수 있습니다: issuerUrl so the plugin can discover the authorization, token, and logout endpoints from the realm metadata:

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);

refresh 토큰을 요청하려면 offline_access 만약 Keycloak의 도메인과 클라이언트가 이 앱에 대해 refresh 토큰을 허용한다면:

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

수동 엔드포인트 fallback

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

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`,
    },
  },
});

인증 연결 호환성

을 사용하고 있다면, 여전히 일반적인 SocialLoginAuthConnect을 초기화할 수 있습니다. oauth2 제공자와 로그인 provider: 'oauth2' 더하기 providerId: 'keycloak'.

참조하세요 Keycloak OpenID Connect 엔드포인트 참조 관련 문서

Keycloak에서 계속

Keycloak을 사용 중이라면 Keycloak 인증 및 계정 흐름을 계획하는 경우 Capgo를 사용하여 @capgo/capacitor-social-login Capgo를 사용하여 @capgo/capacitor-social-login Capgo를 사용하여 @capgo/capacitor-social-login Capgo를 사용하여 @capgo/capacitor-passkey Capgo를 사용하여 @capgo/capacitor-passkey Capgo를 사용하여 @capgo/capacitor-native-biometric Capgo를 사용하여 @capgo/capacitor-native-biometric for the implementation detail in @capgo/capacitor-native-biometric, and @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-social-login 두 단계 인증 구현에 대한 세부 정보입니다.