{"componentChunkName":"component---src-pages-author-author-yaml-id-js","path":"/author/akash-patil/","result":{"data":{"allMarkdownRemark":{"edges":[{"node":{"id":"09a81a89-df06-5f84-ad47-d1ea45d35c7a","html":"

Hey Everyone !!! This blog will walk you through the steps necessary to quickly implement authentication mechanisms for your React application by leveraging LoginRadius and the LoginRadius CLI with the help of examples.

\n

Using the LoginRadius CLI, you can perform basic actions of your LoginRadius Dashboard through the command line. The actions include login, register, logout, social configuration, domain whitelisting, site management, etc. Once the actions are performed, changes will be reflected in your application.

\n

Configuring LoginRadius

\n

Please follow the steps below to install the LoginRadius CLI on your system. Once completed, use the CLI to finish registration on the LoginRadius portal and create your application.

\n

LoginRadius CLI Setup

\n

Mac or Linux

\n\n

Other Platforms

\n\n

Once you have the CLI installed, the following command can be used to complete the registration process via the LoginRadius portal.

\n
$ lr register
\n

This command will open the Portal in the browser, where you can register yourself and create the app.

\n

\"alt_text\"

\n

If you already have a LoginRadius account, use the command below to directly login :

\n
$ lr login
\n

Once you successfully register or login, the below message will be visible in a new tab on the browser. Close the tab and return to the CLI.

\n
You are Successfully Authenticated, Kindly Close this browser window and go back to CLI.
\n

If your account has multiple sites (for Developer/Developer Pro Plans), an option will be given to choose the site that you wish to login with. You can choose a site according to your preference.

\n
$ lr login\n  Successfully Authenticated, Fetching Your Site(s)...\n? Current Site is: <value>, Want to Switch? Yes\n? Select the site from the list: <value>\n  Site has been updated.\n  Successfully Logged In
\n

Fetching Application API Credentials

\n

Once the login/register process has been completed, run the lr get config command to fetch your API Key/Secret as shown below.

\n

\"alt_text\"

\n

Configuring Callback URLs

\n

Here, a callback URL refers to a URL in your application that LoginRadius would redirect a user to after they have been authenticated. These URLs must be added to your Application Configuration. If not set, users will be unable to login into the application and receive an error.

\n

\"alt_text\"

\n

For security reasons, LoginRadius only processes API calls that are received from the whitelisted domains. To get the list of whitelisted domains, run lr get domain command from the CLI. Similarly, to add a domain, use the lr add domain command.

\n
\n

For the purposes of this tutorial, make sure that you set http://localhost as a whitelisted domain.

\n
\n

\"alt_text\"

\n

Setup React JS application

\n

This tutorial uses a demo app based on the Create React App (CRA) boilerplate. For instructions on how to create a React App, refer to the following docs.

\n

The React Demo Application mentioned here will display the User Profile data if the login process is completed successfully.

\n

After setting up the boilerplate:

\n\n
const config = {\n    APP_NAME: '<<App Name>>',\n    API_KEY: '<<API Key>>',\n  };\n  export default config;
\n
\n

This tutorial uses LoginRadius Auth Page(IDX) for authentication, where Registration and Login functionality is already implemented. For example, you can navigate your Register buttons to https://<LoginRadius APP Name>.hub.loginradius.com/auth.aspx?action=register&return_url=<Return URL>.

\n
\n

Add Code to your Application

\n\n
import { BrowserRouter as Router, Route, Switch } from "react-router-dom";\nimport "./App.css";\nimport LandingPage from "./components/LandingPage";\nimport Login from "./components/Login";\nimport Logout from "./components/Logout";\n\nfunction App() {\n  return (\n    <Router>\n      <div className="App">\n        <Switch>\n          <Route exact path="/">\n            <LandingPage />\n          </Route>\n          <Route path="/login">\n            <div style={{ display: "flex", padding: "1em" }}>\n              <Login />\n              <Logout />\n            </div>\n          </Route>\n        </Switch>\n      </div>\n    </Router>\n  );\n}\n\nexport default App;
\n

Add Landing Page

\n

In your components folder under the src folder, create a src/components/LandingPage.js file and add the following code to navigate your Register/Login buttons to the following URL's as shown below.

\n
import React from "react";\nimport config from "../config.js";\nconst LandingPage = () => {\n  return (\n    <div>\n      <h1> React Demo App </h1>\n\n      <a\n        href={`https://${config.APP_NAME}.hub.loginradius.com/auth.aspx?action=register&return_url=${window.location.origin}/login`}\n      >\n        <button>Register</button>\n      </a>\n\n      <a\n        href={`https://${config.APP_NAME}.hub.loginradius.com/auth.aspx?action=login&return_url=${window.location.origin}/login`}\n      >\n        <button>Login</button>\n      </a>\n    </div>\n  );\n};\nexport default LandingPage;
\n

By doing this, we are redirecting our application to the LoginRadius Auth Page and are passing the return_url as the current origin. After successful login, the Login component fetches the user profile data as shown in the following step. However, return_url can also be your website, backend server, etc., where you can handle the access token to perform different actions.

\n

Add Login Component

\n

In your components folder, create a src/components/Login.js file and add the following code to retrieve User Profile Data.

\n
import React from "react";\nimport { withRouter } from "react-router-dom";\nimport config from "../config";\n\nclass Login extends React.Component {\n  constructor(props) {\n    super(props);\n    this.state = {\n      userProfileResponse: null,\n    };\n  }\n\n  componentDidMount() {\n    const token = new URLSearchParams(this.props.location.search).get("token");\n    if (token) {\n      fetch(\n        "`https://api.loginradius.com/identity/v2/auth/account?apikey=" +`\n          config.API_KEY,\n        {\n          method: "GET",\n          headers: {\n            Authorization: "Bearer " + token,\n          },\n        }\n      )\n        .then((res) => res.json())\n        .then((res) => {\n          this.setState({ userProfileResponse: res });\n        })\n        .catch((e) => {\n          console.log(e);\n        });\n    } else {\n      window.location.assign(\n        `https://${config.APP_NAME}.hub.loginradius.com/auth.aspx?action=login&return_url=${window.location.origin}/login`\n      );\n    }\n  }\n\n  render() {\n    const { userProfileResponse } = this.state;\n\n    return (\n      <div>\n        <span style={{ whiteSpace: "pre-wrap", textAlign: "left" }}>\n          {JSON.stringify(userProfileResponse, null, 4)}\n        </span>\n      </div>\n    );\n  }\n}\n\nexport default withRouter(Login);
\n

The Login component will call the LoginRadius API to fetch the user data by making use of the token obtained upon logging in via the LoginRadius Auth Page.

\n

Add Logout component

\n

In your components folder, create a src/components/Logout.js file and add the code as shown below.

\n
import React from "react";\nimport config from "../config.js";\n\nconst Logout = () => {\n  localStorage.removeItem("token");\n\n  return (\n    <div class="container">\n      <a\n        href={`https://${config.APP_NAME}.hub.loginradius.com/auth.aspx?action=logout&return_url=http://localhost:3000/`}\n      >\n        <button>Logout</button>\n      </a>\n    </div>\n  );\n};\nexport default Logout;
\n

This component contains logout functionality. Here, action=logout is passed to the LoginRadius Auth Page, which will log the user out and return them to the Landing Page specified in the return_url.

\n
\n

Full code of the demo can be found on github.

\n
\n

Testing the application

\n

Run the React Application from the command line using npm start. You will be able to see the output on localhost:3000. You can also directly open the IDX page on https://<LoginRadius APP Name>.hub.loginradius.com/auth.aspx?action=register&return_url=http://localhost:3000/login.

\n

Congratulations! You have set up a React Application configured with LoginRadius using LoginRadius CLI. Continue reading to check out some cool and advanced features of the LoginRadius CLI that will help you manipulate and configure the LoginRadius Auth Page for your application through the CLI.

\n

Advanced LoginRadius CLI features

\n

This section explains the use of the LoginRadius CLI in enabling users to quickly and efficiently make changes to the LoginRadius Auth Page configured for their application.

\n

Adding Social Login Methods

\n

We can add social login methods like Google, Facebook, etc., to the LoginRadius Auth Page using the CLI. Use the lr add social command to add a Login method and the lr get social command to view the current active social login methods. Check the image below for a visual representation.

\n

\"alt_text\"

\n

After adding the new login method (in this example, it is Facebook), navigate to the LoginRadius Auth Page by using the lr demo command.

\n

\"alt_text\"

\n

Updating the theme

\n

We can update the theme of the LoginRadius Auth Page using the lr set theme command. You can use the lr get theme command to get a list of all available themes and the currently active theme. See the image below for visual representation.

\n

\"alt_text\"

\n

After changing the theme, navigate to the LoginRadius Auth Page using lr demo command to view the changes.

\n

\"alt_text\"

\n

Adding to the Registration schema

\n
\n

This functionality is only available for paid Developer Plans and above (not available for LoginRadius Free plan).

\n
\n

We can update the Registration Page schema using the lr add schema command. Use the lr get schema command with --active or --all flags to get the current Registration fields or view all available fields with their schemas. You can also configure addtional features by choosing the setup advance configuration option.
\nSee the image below for a visual representation of the command flow.

\n

\"alt_text\"

\n

In the below image 2 fields have been added to the registration schema, Confirm Password and Gender. To view the changes, navigate to the LoginRadius Auth Page using lr democommand.

\n

\"alt_text\"

\n
\n

Instead of using the lr demo command, you can also view the LoginRadius Auth Page by visiting locahost:3000 and following the same workflow as explained earlier.

\n
\n

The entire description for these commands can be found in the LoginRadius CLI Manual.

\n

Contributing to LoginRadius CLI

\n

The LoginRadius CLI is open-sourced under LoginRadius Organization. You are welcome to contribute to it, suggest improvements, or report bugs by following the contributing guidelines. You can also checkout our open source page if you wish to contribute to other opensource projects by LoginRadius.

\n

Your Take

\n

Using the LoginRadius CLI, you can easily setup authentication for your React applications. You can also perform certain LoginRadius functionalities and processes efficiently through the CLI, which saves a bunch of time. LoginRadius will handle all the authentication-related mechanisms so that you can solely concentrate on your application development.

\n

I hope you enjoyed this tutorial and found it to be useful. You can provide feedback or suggestions in the comment section below.

\n

Cheers!!!

\n","frontmatter":{"title":"Implement Authentication in React Applications using LoginRadius CLI ","author":{"id":"Akash Patil","github":"Akash-Patil","avatar":null},"date":"May 12, 2021","updated_date":null,"tags":["Authentication","React","CLI","LoginRadius CLI"],"coverImage":{"childImageSharp":{"fluid":{"aspectRatio":1.5037593984962405,"src":"/static/588aa544e688ead4b827e6e3fee882fb/58556/cover.webp","srcSet":"/static/588aa544e688ead4b827e6e3fee882fb/61e93/cover.webp 200w,\n/static/588aa544e688ead4b827e6e3fee882fb/1f5c5/cover.webp 400w,\n/static/588aa544e688ead4b827e6e3fee882fb/58556/cover.webp 800w,\n/static/588aa544e688ead4b827e6e3fee882fb/99238/cover.webp 1200w","sizes":"(max-width: 800px) 100vw, 800px"}}}},"fields":{"authorId":"Akash Patil","slug":"/engineering/implement-authentication-in-react-using-loginradius-cli/"}}}]},"authorYaml":{"id":"Akash Patil","bio":"Akash Patil, a graduate from BITS Pilani, is currently working as an Associate Software Engineer at LoginRadius. He has worked on projects in backend development and has an interest in learning new technologies and developer tools, especially in the field of Data Science.","github":"Akash-Patil","stackoverflow":null,"linkedin":"akash-patil-100","medium":null,"twitter":null,"avatar":null}},"pageContext":{"id":"Akash Patil","__params":{"id":"akash-patil"}}},"staticQueryHashes":["1171199041","1384082988","2100481360","23180105","528864852"]}