Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Entra Rebrand #19

Merged
merged 1 commit into from
May 23, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,4 +42,4 @@ Verify that the following are valid
* ...

## Other Information
<!-- Add any other helpful information that may be needed here. -->
<!-- Add any other helpful information that may be needed here. -->
18 changes: 9 additions & 9 deletions AppCreationScripts/AppCreationScripts.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
```

1. Run the script to create your Azure AD application and configure the code of the sample application accordingly.
1. Run the script to create your Microsoft Entra application and configure the code of the sample application accordingly.

```PowerShell
cd .\AppCreationScripts\
Expand All @@ -35,23 +35,23 @@

### Presentation of the scripts

This sample comes with two PowerShell scripts, which automate the creation of the Azure Active Directory applications, and the configuration of the code for this sample. Once you run them, you will only need to build the solution and you are good to test.
This sample comes with two PowerShell scripts, which automate the creation of the Microsoft Entra applications, and the configuration of the code for this sample. Once you run them, you will only need to build the solution and you are good to test.

These scripts are:

- `Configure.ps1` which:
- creates Azure AD applications and their related objects (permissions, dependencies, secrets, app roles),
- creates Microsoft Entra applications and their related objects (permissions, dependencies, secrets, app roles),
- changes the configuration files in the sample projects.
- creates a summary file named `createdApps.html` in the folder from which you ran the script, and containing, for each Azure AD application it created:
- creates a summary file named `createdApps.html` in the folder from which you ran the script, and containing, for each Microsoft Entra application it created:
- the identifier of the application
- the AppId of the application
- the url of its registration in the [Azure portal](https://portal.azure.com).
- the url of its registration in the [Microsoft Entra admin center](https://entra.microsoft.com).

- `Cleanup.ps1` which cleans-up the Azure AD objects created by `Configure.ps1`. Note that this script does not revert the changes done in the configuration files, though. You will need to undo the change from source control (from Visual Studio, or from the command line using, for instance, `git reset`).
- `Cleanup.ps1` which cleans-up the Microsoft Entra objects created by `Configure.ps1`. Note that this script does not revert the changes done in the configuration files, though. You will need to undo the change from source control (from Visual Studio, or from the command line using, for instance, `git reset`).

### Usage pattern for tests and DevOps scenarios

The `Configure.ps1` will stop if it tries to create an Azure AD application which already exists in the tenant. For this, if you are using the script to try/test the sample, or in DevOps scenarios, you might want to run `Cleanup.ps1` just before `Configure.ps1`. This is what is shown in the steps below.
The `Configure.ps1` will stop if it tries to create a Microsoft Entra application which already exists in the tenant. For this, if you are using the script to try/test the sample, or in DevOps scenarios, you might want to run `Cleanup.ps1` just before `Configure.ps1`. This is what is shown in the steps below.

## How to use the app creation scripts?

Expand Down Expand Up @@ -118,8 +118,8 @@ Note that the script will choose the tenant in which to create the applications,

if you want to create the apps in a particular tenant, you can use the following option:

- Open the [Azure portal](https://portal.azure.com)
- Select the Azure Active directory you are interested in (in the combo-box below your name on the top right of the browser window)
- Open the [Microsoft Entra admin center](https://entra.microsoft.com)
- Select the Microsoft Entra ID you are interested in (in the combo-box below your name on the top right of the browser window)
- Find the "Active Directory" object in this tenant
- Go to **Properties** and copy the content of the **Directory Id** property
- Then use the full syntax to run the scripts:
Expand Down
2 changes: 1 addition & 1 deletion LICENSE.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,4 +18,4 @@
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE
SOFTWARE
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ languages:
- nodejs
products:
- msal-node
- azure-active-directory
- microsoft-entra-id
description: "Add authentication to a Node.js web application with the Microsoft Authentication Library for Node.js (MSAL Node)."
urlFragment: "ms-identity-node"
---
Expand Down Expand Up @@ -54,10 +54,10 @@ This sample demonstrates the following MSAL Node concepts:

1. Configure authentication and authorization parameters:
1. Open `App/.env.dev`
1. Replace the string `"Enter_the_Application_Id_Here"` with your app/client ID on AAD Portal.
1. Replace the string `"Enter_the_Application_Id_Here"` with your app/client ID on Microsoft Entra admin center.
1. Replace the string `"Enter_the_Cloud_Instance_Id_Here"` with `"https://login.microsoftonline.com/"`
1. Replace the string `"Enter_the_Tenant_Info_Here"` with your tenant ID on AAD Portal.
1. Replace the string `"Enter_the_Client_Secret_Here"` with your client secret on AAD Portal.
1. Replace the string `"Enter_the_Tenant_Info_Here"` with your tenant ID on Microsoft Entra admin center.
1. Replace the string `"Enter_the_Client_Secret_Here"` with your client secret on Microsoft Entra admin center.
1. Configure the parameters for calling MS Graph API:
1. Replace the string `"Enter_the_Graph_Endpoint_Here"` with `"https://graph.microsoft.com/"`
1. Configure the Express session secret:
Expand Down