Native Authentication Single Page App Javascript Sdk Set Up Local Cors
In brief
The 182-line guide for configuring a local CORS proxy for a single-page app using the native authentication JavaScript SDK was deleted.
What Entra admins need to know
No administrator action is specified. Teams relying on this setup will no longer find these instructions at the documented URL.
This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.
Documentation change
The comparison below shows only the changed extract. Use the full-page view for complete context.
deleted file mode 100644
title: Set Up CORS Proxy Server to Manage Headers for SPA With Native Authentication JavaScript SDK
description: Learn how to set up a CORS proxy server for single-page application that uses native authentication JavaScript SDK.
manager: dougeby
ms.service: identity-platform
ms.subservice: external
ms.topic: tutorial
ms.date: 02/07/2025
#Customer intent: As a developer or DevOps engineer, I want to set up a CORS proxy server for a React single-page application that uses native authentication API so that I can manage CORS headers and enable the app to interact with the native authentication API.
Set up CORS proxy server to manage CORS headers for native authentication JavaScript SDK
[!INCLUDE applies-to-external-only]
In this guide, you learn how to set up a local CORS proxy server to manage CORS headers while interacting with native authentication API from your single-page app (SPA). The CORS proxy server is a solution to the native authentication API's inability to support Cross-Origin Resource Sharing (CORS).
You can use the CORS server you set up in this article for local app development. Alternatively:
You can set up a reverse proxy server to manage CORS headers by using Azure Function App for a test environment.In a production environment, you can use Azure Front Door as a reverse proxy.
Create the CORS proxy server
In the root folder of your SPA, create a file calledcors.js, then add the following code:const http = require("http"); const https = require("https"); const url = require("url"); const proxyConfig = require("./proxy.config"); const extraHeaders = [ "x-client-SKU", "x-client-VER", "x-client-OS", "x-client-CPU", "x-client-current-telemetry", "x-client-last-telemetry", "client-request-id", ]; http.createServer((req, res) => { const reqUrl = url.parse(req.url); const domain = url.parse(proxyConfig.proxy).hostname; // Set CORS headers for all responses including OPTIONS const corsHeaders = { "Access-Control-Allow-Origin": "*", "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS", "Access-Control-Allow-Headers": "Content-Type, Authorization, " + extraHeaders.join(", "), "Access-Control-Allow-Credentials": "true", "Access-Control-Max-Age": "86400", // 24 hours }; // Handle preflight OPTIONS request if (req.method === "OPTIONS") { res.writeHead(204, corsHeaders); res.end(); return; } if (reqUrl.pathname.startsWith(proxyConfig.localApiPath)) { const targetUrl = proxyConfig.proxy + reqUrl.pathname?.replace(proxyConfig.localApiPath, "") + (reqUrl.search || ""); console.log("Incoming request -> " + req.url + " ===> " + reqUrl.pathname); const newHeaders = {}; for (let [key, value] of Object.entries(req.headers)) { if (key !== 'origin') { newHeaders[key] = value; } } const proxyReq = https.request( targetUrl, { method: req.method, headers: { ...newHeaders, host: domain, }, }, (proxyRes) => { res.writeHead(proxyRes.statusCode, { ...proxyRes.headers, ...corsHeaders, }); proxyRes.pipe(res); } ); proxyReq.on("error", (err) => { console.error("Error with the proxy request:", err); res.writeHead(500, { "Content-Type": "text/plain" }); res.end("Proxy error."); }); req.pipe(proxyReq); } else { res.writeHead(404, { "Content-Type": "text/plain" }); res.end("Not Found"); } }).listen(proxyConfig.port, () => { console.log("CORS proxy running on http://localhost:3001"); console.log("Proxying from " + proxyConfig.localApiPath + " ===> " + proxyConfig.proxy); });In the root folder of your SPA, create a file calledproxy.config.js, then add the following code:const tenantSubdomain = "Enter_the_Tenant_Subdomain_Here"; const tenantId = "Enter_the_Tenant_Id_Here"; const config = { localApiPath: "/api", port: 3001, proxy: `https://${tenantSubdomain}.ciamlogin.com/${tenantId}`, }; module.exports = config;Find the placeholderEnter_the_Tenant_Subdomain_Hereand replace it with the Directory (tenant) subdomain. For example, if your tenant primary domain iscontoso.onmicrosoft.com, usecontoso. If you don't have your tenant subdomain, learn how to read your tenant details.tenantIdand replace it with the Directory (tenant) ID. If you don't have your tenant ID, learn how to read your tenant details.
Openpackage.jsonfile of your SPA, then add the following command in thescriptsobject:"cors": "node cors.js",
At this point, the CORS proxy server is ready to run.
Run the CORS server
To start the CORS proxy server, run the following command in your terminal:
npm run cors
Related content
@@ -1,184 +0,0 @@-----title: Set Up CORS Proxy Server to Manage Headers for SPA With Native Authentication JavaScript SDK-description: Learn how to set up a CORS proxy server for single-page application that uses native authentication JavaScript SDK.--manager: dougeby-ms.service: identity-platform-ms.subservice: external-ms.topic: tutorial-ms.date: 02/07/2025-#Customer intent: As a developer or DevOps engineer, I want to set up a CORS proxy server for a React single-page application that uses native authentication API so that I can manage CORS headers and enable the app to interact with the native authentication API.------# Set up CORS proxy server to manage CORS headers for native authentication JavaScript SDK--[!INCLUDE [applies-to-external-only](../external-id/includes/applies-to-external-only.md)]--In this guide, you learn how to set up a local CORS proxy server to manage CORS headers while interacting with native authentication API from your single-page app (SPA). The CORS proxy server is a solution to the native authentication API's inability to support [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/docs/Web/HTTP/CORS).--You can use the CORS server you set up in this article for local app development. Alternatively:-- You can [set up a reverse proxy server to manage CORS headers by using Azure Function App](how-to-native-authentication-cors-solution-test-environment.md) for a test environment.-- In a production environment, you can [use Azure Front Door as a reverse proxy](how-to-native-authentication-cors-solution-production-environment.md).---<!--In this tutorial, you:-->[!div class="checklist"]->-> - Create CORS proxy server.-> - Set up the CORS proxy server to call the native authentication API.-> - Run and test your React app. -->--## Create the CORS proxy server--1. In the root folder of your SPA, create a file called *cors.js*, then add the following code:-- ```javascript- const http = require("http");- const https = require("https");- const url = require("url");- const proxyConfig = require("./proxy.config");- - const extraHeaders = [- "x-client-SKU",- "x-client-VER",- "x-client-OS",- "x-client-CPU",- "x-client-current-telemetry",- "x-client-last-telemetry",- "client-request-id",- ];- http.createServer((req, res) => {- const reqUrl = url.parse(req.url);- const domain = url.parse(proxyConfig.proxy).hostname;- - // Set CORS headers for all responses including OPTIONS- const corsHeaders = {- "Access-Control-Allow-Origin": "*",- "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS",- "Access-Control-Allow-Headers": "Content-Type, Authorization, " + extraHeaders.join(", "),- "Access-Control-Allow-Credentials": "true",- "Access-Control-Max-Age": "86400", // 24 hours- };- - // Handle preflight OPTIONS request- if (req.method === "OPTIONS") {- res.writeHead(204, corsHeaders);- res.end();- return;- }- - if (reqUrl.pathname.startsWith(proxyConfig.localApiPath)) {- const targetUrl = proxyConfig.proxy + reqUrl.pathname?.replace(proxyConfig.localApiPath, "") + (reqUrl.search || "");- - console.log("Incoming request -> " + req.url + " ===> " + reqUrl.pathname);- - const newHeaders = {};- for (let [key, value] of Object.entries(req.headers)) {- if (key !== 'origin') {- newHeaders[key] = value;- }- }- - const proxyReq = https.request(- targetUrl,- {- method: req.method,- headers: {- ...newHeaders,- host: domain,- },- },- (proxyRes) => {- res.writeHead(proxyRes.statusCode, {- ...proxyRes.headers,- ...corsHeaders,- });- - proxyRes.pipe(res);- }- );- - proxyReq.on("error", (err) => {- console.error("Error with the proxy request:", err);- res.writeHead(500, { "Content-Type": "text/plain" });- res.end("Proxy error.");- });- - req.pipe(proxyReq);- } else {- res.writeHead(404, { "Content-Type": "text/plain" });- res.end("Not Found");- }- }).listen(proxyConfig.port, () => {- console.log("CORS proxy running on http://localhost:3001");- console.log("Proxying from " + proxyConfig.localApiPath + " ===> " + proxyConfig.proxy);- });- ```--1. In the root folder of your SPA, create a file called *proxy.config.js*, then add the following code:-- ```javascript- const tenantSubdomain = "Enter_the_Tenant_Subdomain_Here";- const tenantId = "Enter_the_Tenant_Id_Here";- - const config = {- localApiPath: "/api",- port: 3001,- proxy: `https://${tenantSubdomain}.ciamlogin.com/${tenantId}`,- };- module.exports = config;- ```-- - Find the placeholder `Enter_the_Tenant_Subdomain_Here` and replace it with the Directory (tenant) subdomain. For example, if your tenant primary domain is `contoso.onmicrosoft.com`, use `contoso`. If you don't have your tenant subdomain, learn how to [read your tenant details](../external-id/customers/how-to-create-external-tenant-portal.md#get-the-external-tenant-details).-- - `tenantId` and replace it with the Directory (tenant) ID. If you don't have your tenant ID, learn how to [read your tenant details](../external-id/customers/how-to-create-external-tenant-portal.md#get-the-external-tenant-details).--1. Open *package.json* file of your SPA, then add the following command in the *scripts* object:-- ```json- "cors": "node cors.js",- ```--At this point, the CORS proxy server is ready to run.--## Run the CORS server--To start the CORS proxy server, run the following command in your terminal:--```console-npm run cors-```---<!--1. Open a terminal window and navigate to the root folder of your app:-- ```console- cd reactspa- ```--1. To start the CORS proxy server, run the following command in your terminal:-- ```console- npm run cors- ```--1. To start the React app, open another terminal window, then run the following command:-- ```console- cd reactspa- npm start- ```--1. Open a web browser and navigate to `http://localhost:3000/`. A sign-up form appears.--1. To sign up for an account, input your details, select the **Sign Up** button, then follow the prompts.---At this point, you've successfully created a React app that can sign up a user by using the native authentication API. Next, you can update the React app to sign in a user or reset the user's password. -->---## Related content--- [Tutorial: Sign in users into a React single-page app app by using native authentication](tutorial-native-authentication-single-page-app-react-sign-in.md).-- [Tutorial: Reset password in a React single-page app app by using native authentication](tutorial-native-authentication-single-page-app-react-reset-password.md).\ No newline at end of file 