Authentication

Authentication with OneID SSO SDK

OneID currently uses a Single Sign On (SSO) technique for authentication. You may use the OneID SDK to authenticate users, check authentication status, retrieve their OneID profile, and log them out. The various methods provided by OneID SDK to carry out these functionalities are below:

Sign in with OneID popup

When you use the handleAuth() method, a window will pop up which performs the authentication before returning you to the application. The handleAuth() method is as follows:

JavaScript

📌 Required environment

The code snippet below only works in a browser-enabled environment, as it triggers a popup window.

import { handleAuth } from 'oneid-sdk';

btn.addEventListener('click', (e) => {
    e.preventDefault()

    try {
        const response = await handleAuth();
        console.log(response);
    } catch (error) {
        return console.log(error);
    }
})

ReactJs

📌 Required environment

The code snippet below only works in a browser-enabled environment, as it triggers a popup window.

import React from "react";
import { useOneid } from "react-oneid";

function App() {
  const { handleAuth } = useOneid();

  return (
    <div>
      <button onClick={
        () => handleAuth()
      }>Authenticate</button>
    </div>
  );
}

React Native

import { useOneid } from "oneid-react-native";

const YourApp = () => {
  const { login } = useOneid();

  const handleLogin = async () => {
    try {
      const user = await login();
      console.log(user);
    } catch (error) {
      console.log(error);
    }
  };

  return (
    <View>
      <Button title="Login" onPress={handleLogin} />
    </View>
  );
};

Flutter

User login can be initiated with the oneId method:

Parameters

• BuildContext current buildcontext of your app.

final res = await oneIdPlugin!.oneId(context: context);

This function returns a user object and a token as an object.

data	Data type	Description
user	Object	The user object contains the _id, email, oneId(the user's OneID ID), profile(the user's OneID profile object), and username.
token	String	The authenticated string assign to each user for signing requests made to the OneID API