메서드

Wepin React Native Login Library에서 제공하는 메서드 입니다.

loginWithOauthProvider

await wepinLogin.loginWithOauthProvider(params);

인앱 브라우저가 열리고 OAuth 프로바이더에로그인합니다. Firebase 로그인 정보를 가져오려면 loginWithIdToken() 또는 loginWithAccessToken() 메서드를 호출해야 합니다.

Parameters

  • params <object>

    • provider <'google'|'naver'|'discord'|'apple'>

      OAuth 로그인 프로바이더

    • clientId <string>

      OAuth 로그인 프로바이더의 클라이언트 ID

Returns

  • Promise<LoginOauthResult>

    • provider <'google'|'naver'|'discord'|'apple'>

      사용된 OAuth Provider의 이름

    • token <string>

      accessToken (Provider가 "naver" 또는 "discord"일 경우) 또는 idToken (Provider가 "google" 또는 "apple"일 경우)

    • type <'id_token'|'access_token'>

      OAuth 토큰의 유형

Exception

Example

const user = await wepinLogin.loginWithOauthProvider({
  provider: "google",
  clientId: "your-google-client-id"
});

signUpWithEmailAndPassword

await wepinLogin.signUpWithEmailAndPassword(email, password, locale?)

이메일과 비밀번호를 사용하여 Wepin Firebase에 가입합니다. 가입이 성공하면 Firebase 로그인 정보를 반환합니다.

Parameters

  • email <string>

    사용자 이메일

  • password <string>

    사용자 비밀번호

  • locale <string> optional

    인증 이메일의 언어 설정 (기본 값: "en")

Returns

  • Promise<LoginResult>

    • provider <string>

      로그인에 사용된 프로바이더(이 경우, 'email')

    • token <object>

      • idToken <string>

        Wepin Firebase ID Token

      • refreshToken <string>

        Wepin Firebase refresh Token

Exception

Example

const user = await wepinLogin.signUpWithEmailAndPassword(
  'abc@defg.com', 
  'abcdef123&'
);

loginWithEmailAndPassword

await wepinLogin.loginWithEmailAndPassword(email, password);

이메일과 비밀번호를 사용하여 Wepin Firebase에 로그인합니다. 로그인에 성공하면 Firebase 로그인 정보를 반환합니다.

Parameters

  • email <string> 사용자 이메일

  • password <string> 사용자 비밀번호

Returns

  • Promise<LoginResult>

    • provider <'email'>

      로그인에 사용된 Provider

    • token <object>

      • idToken <string>

        Wepin Firebase ID Token

      • refreshToken <string>

        Wepin Firebase refresh Token

Exception

Example

const user = await wepinLogin.loginWithEmailAndPassword(
  'abc@defg.com', 
  'abcdef123&'
);

loginWithIdToken

await wepinLogin.loginWithIdToken(params);

외부 ID 토큰을 사용하여 Wepin Firebase에 로그인합니다. 로그인에 성공하면 Firebase 로그인 정보를 반환합니다.

Parameters

  • params<object>

    • idToken <string> 로그인에 사용될 ID Token 값

    • sign <string> ID 토큰의 서명 값 (getSignForLogin()의 반환값)

Returns

  • Promise<LoginResult>

    • provider <'external_token'> 로그인에 사용된 프로바이더

    • token <object>

      • idToken <string>

        Wepin Firebase ID Token

      • refreshToken <string>

        Wepin Firebase refresh Token

Exception

Example

const user = await wepinLogin.loginWithIdToken({
    idToken:'eyJHGciO....adQssw5c', 
    sign:'9753d4dc...c63466b9'
});

loginWithAccessToken

await wepinLogin.loginWithAccessToken(params);

외부 Access Token을 사용하여 Wepin Firebase에 로그인합니다. 로그인에 성공하면 Firebase 로그인 정보를 반환합니다.

Parameters

  • params<object>

    • provider <"naver"|"discord">

      Access Token을 발급한 프로바이더

    • accessToken <string>

      로그인에 사용될 Access Token 값

    • sign <string>

      Access Token의 서명 값 (returned value of getSignForLogin())

Returns

  • Promise<LoginResult>

    • provider <string>

      로그인에 사용된 프로바이더(in this case, 'external_token')

    • token <object>

      • idToken <string>

        Wepin Firebase ID Token

      • refreshToken <string>

        Wepin Firebase refresh Token

Exception

Example

const user = await wepinLogin.loginWithAccessToken({
  provider: 'naver',
  token: 'eyJHGciO....adQssw5c',
  sign: '9753d4dc...c63466b9',
});

getRefreshFirebaseToken

await wepinLogin.getRefreshFirebaseToken();

현재 Wepin Firebase 토큰의 정보를 가져옵니다.

Parameters

  • None

Returns

  • Promise<LoginResult>

    • provider <string> 로그인에 사용된 프로바이더

      • <'google'|'apple'|'naver'|'discord'|'email'|'external_token'>

    • token <object>

      • idToken <string> Wepin Firebase ID Token

      • refreshToken <string> Wepin Firebase refresh Token

Exception

Example

const user = await wepinLogin.getRefreshFirebaseToken();

loginWepin

await wepinLogin.loginWepin({ provider, token });

Wepin Firebase Token을 사용하여 사용자를 위핀에 로그인합니다.

Parameters

Returns

  • Promise<IWepinUser>

    • status <'success'|'fail'>

      로그인 상태

    • userInfo <object>optional - 사용자의 정보

      • userId <string>

        사용자의 ID

      • email <string>

        사용자의 이메일

      • provider <'google'|'apple'|'naver'|'discord'|'email'|'external_token'>

        로그인 Provider

      • use2FA <boolean>

        사용자가 이중 인증을 사용하는지 여부

    • walletId <string>

      사용자의 지갑 ID

    • userStatus <object> -사용자의 위핀 로그인 상태

      • loginStats <'complete' | 'pinRequired' | 'registerRequired'>

        사용자의 loginStatus 값이 'complete'가 아닌 경우, 사용자는 위핀에 register해야 합니다.

      • pinRequired <boolean>optional

        PIN이 필요한지 여부

    • token <object>

      사용자의 Wepin Token

      • accessToken <string> Access Token

      • refreshToken <string> Refresh Token

Exception

Example

const wepinLogin = WepinLogin({ appId: 'appId', appKey: 'appKey' });
const res = await wepinLogin.loginWithOauthProvider({ 
  provider: 'google', 
  clientId: 'clientId'
});

const userInfo = await wepinLogin.loginWepin(res);
const userStatus = userInfo.userStatus;
if (
  userStatus.loginStatus === 'pinRequired' ||
  userStatus.loginStatus === 'registerRequired'
) {
  // wepin register
}

getCurrentWepinUser

await wepinLogin.getCurrentWepinUser();

위핀에 현재 로그인한 사용자의 정보를 가져옵니다.

Parameters

  • None

Returns

  • Promise<IWepinUser>

    • status <'success'|'fail'>

      로그인 상태

    • userInfo <object>optional - 사용자의 정보

      • userId <string>

        사용자의 ID

      • email <string>

        사용자의 이메일

      • provider <'google'|'apple'|'naver'|'discord'|'email'|'external_token'>

        로그인 Provider

      • use2FA <boolean>

        사용자가 이중 인증을 사용하는지 여부

    • walletId <string>

      사용자의 지갑 ID

    • userStatus <object> -사용자의 위핀 로그인 상태

      • loginStats <'complete' | 'pinRequired' | 'registerRequired'>

        사용자의 loginStatus 값이 'complete'가 아닌 경우, 사용자는 위핀에 register해야 합니다.

      • pinRequired <boolean>optional

        PIN이 필요한지 여부

    • token <object>

      사용자의 Wepin Token

      • accessToken <string> Access Token

      • refreshToken <string> Refresh Token

Exception

Example

const userInfo = await wepinLogin.getCurrentWepinUser();
const userStatus = userInfo.userStatus;
if (
  userStatus.loginStatus === 'pinRequired' ||
  userStatus.loginStatus === 'registerRequired'
) {
  // wepin register
}

logout

await wepinLogin.logout();

위핀에 로그인한 사용자를 로그아웃합니다.

Parameters

  • None

Returns

  • Promise<boolean>

Exception

Example

const result = await wepinLogin.logout();
if (result) {
  // Successfully logged out
}

getSignForLogin

발급자를 확인하기 위한 서명을 생성합니다. 주로 ID Token 및 Access Token과 같은 로그인 관련 정보를 위한 서명을 생성하는 데 사용됩니다.

import { getSignForLogin } from '@wepin/login-rn';
const result = getSignForLogin(privKey, message);

Parameters

  • privateKey <string> 서명 생성에 사용되는 인증 키

  • message <string> 서명될 메시지 또는 페이로드

서명에 사용할 키는 위핀 워크스페이스에서 발급 받을 수 있습니다. 개발 도구 메뉴에서 로그인 탭의 인증키 발급 받기를 클릭하여 인증키를 확인하세요.

Returns

  • <string> 생성된 서명

인증 키(privateKey)는 반드시 안전하게 보관되어야 하며, 외부에 노출되지 않도록 주의해야 합니다. 보안과 민감한 정보 보호를 위해 getSignForLogin() 메서드는 프론트엔드가 아닌 백엔드에서 실행하는 것이 권장됩니다. 서명 생성 방법에 대해서는 아래 문서를 참고하세요.

Example

const sign = getSignForLogin(
    '0400112233445566778899001122334455667788990011223344556677889900',
    'idtokenabcdef'
);

const res = await wepinLogin.loginWithIdToken(
    'eyJHGciO....adQssw5c', 
    sign
);

finalize

await wepinLogin.finalize();

Wepin Login Library 를 종료합니다.

Parameters

  • None

Returns

  • Promise<void>

Example

await wepinLogin.finalize();

WepinLoginException

Last updated