[Azure docs] Replace Azure AD with Microsoft Entra ID

[alaudazzi]

Microsoft renamed Azure Active Directory (Azure AD) to Microsoft Entra ID.
Refer to https://learn.microsoft.com/en-gb/entra/fundamentals/new-name.

This PR updates the following Elastic integrations doc pages:

• Azure Active Directory
• Azure Logs

Related issues

Closes https://github.com/elastic/integration-docs/issues/325

[elasticmachine]

🚀 Benchmarks report

To see the full report comment with /test benchmark fullreport

[zmoog]

We are replacing the name "Azure Active Directory" in the docs while the integration title, including buttons and icons, stays unchanged.

Do we have plans to change these in a different PR, or should we also update them in this one?

[zmoog]

Turning this docs-focused PR into a rebrand would also help in the integration search:

[zmoog]

I hope you don't mind if I fixed a couple of diagrams with rendering issues:

(1) Before:

(1) After:

I hope you don't mind if I fixed a couple of diagrams with rendering issues:

(2) Before:

(2) After:

[alaudazzi]

@zmoog
Thank you for reviewing and fixing the diagrams!

To your question:

Do we have plans to change these in a different PR, or should we also update them in this one?

This is the Kibana UI, so I guess we need to find a contact on the Kibana team.

[zmoog]

This is the Kibana UI, so I guess we need to find a contact on the Kibana team.

IIRC, Kibana builds the UI elements using the information in the YAML files from the integration source. Let me check!

[zmoog]

Yep, most of the text in the UI elements come from the metadata in the integration YAML files:

CleanShot.2024-05-03.at.12.57.23.mp4

[alaudazzi]

I will ask the Kibana team.

[zmoog]

It seems we can do this by updating the metadata in the manifest.yml file:

diff --git a/packages/azure/manifest.yml b/packages/azure/manifest.yml
index 38c28d051..3e76aa8ed 100644
--- a/packages/azure/manifest.yml
+++ b/packages/azure/manifest.yml
@@ -94,8 +94,8 @@ policy_templates:
         size: 5002x2666
         type: image/png
   - name: adlogs
-    title: Azure Active Directory
-    description: Azure Directory logs integration
+    title: Microsoft Entra ID
+    description: Collect logs from Microsoft Entra ID (formerly Azure Active Directory) with Elastic Agent.
     data_streams:
       - auditlogs
       - signinlogs
@@ -105,7 +105,7 @@ policy_templates:
       - security
     inputs:
       - type: "azure-eventhub"
-        title: "Collect Azure Active Directory logs from Event Hub"
+        title: "Collect Microsoft Entra ID logs from Event Hub"
         description: "Collecting Active Directory logs as audit logs and signin logs from Azure instances (input: azure-eventhub)"
         input_group: logs
     icons:

[alaudazzi]

@zmoog
As agreed, to keep docs and UI in sync, we'll handle the Kibana UI updates in this PR.
Thank you for updating the manifest.yml file 🙏

[efd6]

Alphabetical order?

[zmoog]

@efd6, thanks for taking the time to align the text in the diagram! I was about to do the same, but I'll take and commit yours! 😇

[zmoog]

Final result for (1) integration metadata and (2) diagrams.

CleanShot.2024-05-06.at.09.54.07.mp4

[shmsr]

nits

[muthu-mps]

@alaudazzi - Can we rebuild the package and push the README file changes?

[zmoog]

I made two last changes:

• sort services alphabetically
• replace the Azure Active Directory logo with the Microsoft Entra ID logo

CleanShot.2024-05-07.at.16.05.07.mp4

[muthu-mps]

Since we are rebranding the Azure AD to Microsoft Entra ID. Can this be an enhancement?

[alaudazzi]

We are fixing a product name that is now obsolete. If it makes more sense to call it "enhancement", that's fine with me.

[muthu-mps]

@zmoog - This diagram is still referring to Active Directory service. We need to update it to Entra ID.

(2) After:

[zmoog]

I found a few other leftovers searching for the following terms:

• Active Directory
• Azure AD

Can you think of any other case?

[muthu-mps]

I found a few other leftovers searching for the following terms:

• Active Directory
• Azure AD

Can you think of any other case?

I am able to find the above mentioned terms. We are good!

[muthu-mps]

@zmoog - The pipeline test data and the generated sample events might have references to the Active Directory. Do you think we need to update the references here as well? IMO, No need to update the test file references.

[muthu-mps]

LGTM!

[zmoog]

The pipeline test data and the generated sample events might have references to the Active Directory. Do you think we need to update the references here as well? IMO, No need to update the test file references.

Yeah, I agree there is no need to update the existing test cases. They were generated when Azure AD was the service name.

[elasticmachine]

💚 Build Succeeded

• Buildkite Build
• Commit: fcbb487

History

• 💔 Build #11229 failed db60fce
• 💚 Build #11223 succeeded a46af7f
• 💚 Build #11222 succeeded 5b8638f
• 💚 Build #11221 succeeded 0c97f73
• 💚 Build #11217 succeeded 9d3c65a

cc @alaudazzi

[elastic-sonarqube]

Quality Gate passed

Issues
0 New issues
0 Fixed issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarQube

[elasticmachine]

Package azure - 1.11.4 containing this change is available at https://epr.elastic.co/search?package=azure