Embedded Login Integration (Vanilla.js)
What will we build?
In this quick start, we will add the Frontegg embedded login box to your Vanilla JS application.
5 minutes from now, your application will have a login box with Sign in, Sign up, and SSO. All this with just a few lines of code using redirects, Open Id Connect, and OAuth2.
⚡ Before you start: ⚡
Getting your Frontegg subdomain and clientId
Frontegg creates a unique
subdomain
andclient id
for every environment created on the account. In order to retrieve theclientId
subdomain
that will act as thebaseUrl
in the integration, navigate to your workspace 'Settings' menu, 'Domains' and copy theFrontegg domain
andclientId
.You will need them for this guide.
STEP 1: Adding Frontegg to your app
Frontegg can be added to your app via NPM / script on your application head
npm install @frontegg/js
yarn add @frontegg/js
<head>
...
<script type="application/javascript" src="https://cdn.jsdelivr.net/npm/@frontegg/js/umd/frontegg.production.min.js"></script>
</head>
STEP 2: Configure
Frontegg works with Context options and needs to be initialized with this context. In order to initialize Frontegg use the following code snippet
Add the following script to initialize Frontegg on your application and to interact with the login page
import {initialize} from "@frontegg/js"
const style = document.createElement('style');
style.setAttribute('type', 'text/css');
style.innerHTML = '';
document.getElementsByTagName('head')[0].appendChild(style);
const app = initialize({
contextOptions: {
baseUrl: "https://[YOUR_SUBDOMAIN].frontegg.com", //set your Frontegg environment domain and client ID here
},
hostedLoginBox: false
})
Add the representative HTML button that will redirect the UI to the login page. Clicking on the button should take you to the login dialog.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
<style>
button {
border-radius: 4px;
background: dodgerblue;
color: white;
border: 0;
padding: 8px 16px;
}
</style>
</head>
<body>
<div id="app-root" style="display: none">
<h1>This is Frontegg Integration in Vanilla Javascript </h1>
<div id="user-container">
</div>
<br/>
<a fe-state="isAuthenticated" href="/account/logout"><button>Logout</button></a>
<a fe-mode="embedded" fe-state="!isAuthenticated" href="/account/login"><button>Login</button></a>
</div>
<script src="/bundle.js"></script>
</body>
</html>
STEP 3: Grab the user context
The user context is available from the Frontegg app. Upon initialization, you can subscribe to state notifications which will include whether the user is authenticated or not and what is the JWT of the user.
In order to subscribe to user state notifications, add the following code snippet:
import {initialize} from "@frontegg/js"
const style = document.createElement('style');
style.setAttribute('type', 'text/css');
style.innerHTML = '';
document.getElementsByTagName('head')[0].appendChild(style);
const app = initialize({
contextOptions: {
baseUrl: "https://[YOUR_SUBDOMAIN].frontegg.com", //set your Frontegg environment domain and client ID here
},
hostedLoginBox: false
})
app.store.subscribe(() => {
const state = app.store.getState();
if (state.auth.user) {
document.getElementById('user-container').innerText = state.auth.user.email;
} else {
document.getElementById('user-container').innerText = 'Not Authenticated'
}
document.getElementById('app-root').style.display = state.auth.isLoading ? 'hidden' : 'block'
let styleHtml = ''
if (state.auth.isAuthenticated) {
styleHtml += '[fe-state="isAuthenticated"] { }';
styleHtml += '[fe-state="!isAuthenticated"] { display: none; }';
} else {
styleHtml += '[fe-state="isAuthenticated"] { display: none; }';
styleHtml += '[fe-state="!isAuthenticated"] { }';
}
style.innerHTML = styleHtml;
})
Great, Frontegg is now integrated with your app!
Avoid Clickjacking
To prevent Clickjacking vulnerabilities, make sure you add an
X-Frame-Options
Header withSAMEORIGIN
value to your hosting service.
Updated 9 months ago