capgo/capacitor-social-login

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

시작하기 GitHub

개요

@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 이중화 경로입니다.

포크 및 이중화 노트

This plugin은 @codetrix-studio/capacitor-google-auth의 포크로 시작되었습니다. 원래 패키지는 사실상 폐기되었으므로 Capgo는 이 플러그인을 지원하는 대체로 유지합니다.

Ionic Auth Connect로 이중화하는 경우 built-in @codetrix-studio/capacitor-google-auth이중화하는 경우 Ionic Auth Connect의 legacy Google Auth 이중화 가이드를 따르세요..

이중화하는 경우 Ionic Auth Connect의 SocialLoginAuthConnect __CAPGO_KEEP_0__ auth0, azure, cognito, okta의 wrapper onelogin 및

Keycloak 설정

제목 ‘호환성’	Capacitor compatibility	__CAPGO_KEEP_0__ 호환성
유지보수됨	v8.x	예
v7.x	v7.x	사용자 요청 시
v6.x	v6.x	아니요
v5.x	v5.x	아니요

Capacitor의 주요 버전을 따라하는 이 플러그인의 주요 버전은 Capacitor 8을 사용하는 예와 같이 Capacitor의 주요 버전만 활성으로 유지됩니다.

비디오 Walkthrough

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

기본 기능

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

공개 API

기법	설명
`initialize`	플러그인을 초기화합니다.
`login`	선택한 제공자로 로그인합니다.
`logout`	로그아웃.
`isLoggedIn`	로그인 상태 여부.
`getAuthorizationCode`	현재 인증 code을 가져옵니다.
`refresh`	액세스 토큰을 갱신합니다.
`refreshToken`	OAuth2 리프레시 토큰 헬퍼입니다.
`handleRedirectCallback`	OAuth2 내장 제공자용 OAuth2 리프레시 토큰 헬퍼입니다.
`decodeIdToken`	웹 전용: OAuth 리다이렉트 콜백을 처리하고 파싱된 결과를 반환합니다.
`getAccessTokenExpirationDate`	JWT (OIDC ID 토큰)를 클레임으로 디코딩합니다. (일반적으로 JWT를 디코딩합니다.)
`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 in capacitor-social-login.

__CAPGO_KEEP_0__을 사용하는 경우 @capgo/capacitor-social-login __CAPGO_KEEP_0__을 사용하여 인증 및 계정 흐름을 계획하고 Using @capgo/capacitor-social-login for the native capability in Using @capgo/capacitor-social-login, @capgo/capacitor-passkey for the implementation detail in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric Capgo의 @capgo/capacitor-native-biometric 구현 세부 사항 두 단계 인증 Capgo의 두 단계 인증 구현 세부 사항, 그리고 SSO (기업) Capgo의 SSO (기업) 구현 세부 사항.