This library is a stop gap until Amazon releases a full React-Native SDK.
This library focuses on management of Cognito identities: Signup, Get session tokens, Forgot password workflows etc. I also created a React Native demo application that uses this library: https://github.com/jverhoeven/ReactNativeCognitoDemo.
- Allow new users to sign up, verify e-mail address.
- Allow users to go through 'forgot password' scenario when needed.
- Get a session token as JWT token which can be used to access web APIs.
- You need to store the password on the client. Currently the refresh token is not used to get new session tokens.
- It assumes the e-mail address is the username.
- Not all functionality is implemented, e.g. you cannot change the e-mail address after signup.
- No tests.
- Android only does region EU-WEST-1
$ npm install react-native-cognito-identity --save
$ react-native link react-native-cognito-identity
For iOS you need to do following as well:
Download the AWS iOS SDK: https://aws.amazon.com/mobile/sdk/
Unpack it, from the /Frameworks folder take
AWSCognito.framework AWSCognitoIdentityProvider.framework AWSCore.framework
and copy them into the node_modules/react-native-cognito-identity/ios/Frameworks/ folder.
The AWS framework packages are not included to avoid the need to update them.
import RNCognitoIdentity from 'react-native-cognito-identity'; // Example, sign up with a new email (i.e. username) and password: const signupResponse = await RNCognitoIdentity.signUp(email, password); // Then get the verification code sent via e-mail via the GUI and call: result = await RNCognitoIdentity.confirmSignUp(email, verificationCode); // Then you should be able to login: var session = await RNCognitoIdentity.getSession(email, password); // When successful, the session object should contain JWT tokens: console.log("The idToken: " + session["idToken"]); console.log("The accessToken: " + session["accessToken"]); console.log("The refreshToken: " + session["refreshToken"]); console.log("The expirationTime: " + session["expirationTime"]); //iOS only
For a full example go to https://github.com/jverhoeven/ReactNativeCognitoDemo.
This is a minimal implementation that satisfies my own applications. Obviously you will want to:
- Implement the full interface
- (Automatically) refresh the session tokens using the refreshToken, so you don't have to store the password.
- Write tests.