capgo/capacitor-social-login

모든 사회적 로그인 플러그인

개요

@capgo/capacitor-social-login 웹, iOS, Android를 위한 모든-in-one 사회 인증 플러그인입니다.

구현하는 기능은 다음과 같습니다.

구글 시그니니드와 안드로이드 크레덴셜 매니저
애플 로그인, 안드로이드에서 OAuth를 포함하여
Facebook 로그인에 사용되는 현재 Facebook SDK
Twitter/X를 통한 OAuth 2.0
Generic OAuth2 및 OIDC 제공자, Microsoft Entra ID, Auth0, Okta, Keycloak 및 기타 호환 서버를 포함한 GitHub

이 플러그인은 또한 Ionic Appflow Social Login 또는 Ionic Auth Connect로 이동하는 앱의 Capgo 마이그레이션 경로입니다.

포크 및 마이그레이션 노트

이 플러그인은 @codetrix-studio/capacitor-google-auth. The original package is effectively archived, so Capgo maintains this plugin as the supported replacement.

이 플러그인은 지원되는 대체품으로 유지하고 있습니다. @codetrix-studio/capacitor-google-authIonic Auth Connect로 마이그레이션 중인 경우, built-in 이전 버전의 Google Auth 마이그레이션 가이드를 따르세요..

Ionic Auth Connect로 마이그레이션 중인 경우, built-in SocialLoginAuthConnect __CAPGO_KEEP_0__ auth0, azure, cognito, okta소셜 로그인 플러그인 onelogin 기존 provider 이름:

호환성

플러그인 버전	Capacitor 호환성	유지보수
v8.x	v8.x	예
v7.x	v7.x	필요 시
v6.x	v6.x	아니요
v5.x	v5.x	아니요

Capacitor의 주요 버전을 따르는 이 플러그인의 주요 버전은 Capacitor의 주요 버전을 따릅니다. 예를 들어, Capacitor 8과 함께 플러그인 v8을 사용합니다. 가장 최근의 주요 버전만 활성으로 유지됩니다.

동영상_walkthrough

이 플러그인 설정 및 로그인 흐름을 빠르게 시연해 보세요.

핵심 기능

initialize - 플러그인을 초기화합니다.
login - 선택한 제공자와 로그인합니다.
logout - 로그아웃합니다.
isLoggedIn - isLoggedIn.

공개된 API

기법	설명
`initialize`	플러그인을 초기화합니다.
`login`	선택한 제공자와 로그인합니다.
`logout`	로그아웃합니다.
`isLoggedIn`	로그인 상태 여부.
`getAuthorizationCode`	현재 인증 code을 가져옵니다.
`refresh`	액세스 토큰을 갱신합니다.
`refreshToken`	OAuth2 리프레시 토큰 헬퍼입니다.
`handleRedirectCallback`	웹 전용: OAuth 리다이렉트 콜백을 처리하고 파싱된 결과를 반환합니다.
`decodeIdToken`	JWT (OIDC ID 토큰)를 클레임으로 디코딩합니다.
`getAccessTokenExpirationDate`	액세스 토큰 만료 시간 (밀리초 시대)으로 ISO 날짜 문자열을 변환합니다.
`isAccessTokenAvailable`	액세스 토큰이 존재하는지 확인합니다 (비어 있지 않음).
`isAccessTokenExpired`	액세스 토큰이 만료되었는지 확인합니다.
`isRefreshTokenAvailable`	리프레시 토큰이 존재하는지 확인합니다 (비어 있지 않음).
`providerSpecificCall`	제공자별 호출을 실행합니다.
`getPluginVersion`	자연 Capacitor 플러그인 버전을 가져옵니다.
`openSecureWindow`	OAuth2 인증을 위해 안전한 창을 열립니다. 웹에서, code이 리다이렉트된 페이지에 있어야 하며, 리다이렉트된 URL을 앱으로 보내기 위해 방송 채널을 사용할 수 있습니다. 예를 들어: `html <html> <head></head> <body> <script> const searchParams = new URLSearchParams(location.search) if (searchParams.has("code")) { new BroadcastChannel("my-channel-name").postMessage(location.href); window.close(); } </script> </body> </html>` 모바일에서, 앱을 열 수 있는 리다이렉트 URI를 등록해야 합니다. 예를 들어: `myapp://oauth_callback/` 앱의 info.plist에 다음을 등록하세요: `xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array>` AndroidManifest.xml 파일에 다음을 등록하세요: `xml <activity> <intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:host="oauth_callback" android:scheme="myapp" /> </intent-filter> </activity>` .

실질적인 출처

이 참조는 src/definitions.ts 내 capacitor-social-login.

Capgo를 사용하여 인증 및 계정 흐름을 계획하고 있다면 @capgo/capacitor-social-login @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-social-login을 사용하여 Capgo의 @capgo/capacitor-social-login을 사용하여 @capgo/capacitor-passkey @capgo/capacitor-passkey의 구현 세부 정보를 위해 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric Capacitor @capgo/capacitor-native-biometric 두 단계 인증 Capacitor @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-biometric, 그리고 SSO (기업) Capacitor @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-biometric (기업)에서 구현 세부 정보