feat (docs): added azuread's guide (#2915)

### **PR Type**
Enhancement, Documentation


___

### **Description**
- Added a comprehensive guide for signing in with Azure AD (Azure Active
Directory)
- Provided detailed instructions for setting up Azure AD in the Azure
Portal
- Explained the process of configuring Nhost to work with Azure AD
- Included a code snippet demonstrating how to implement Azure AD
sign-in using the Nhost JavaScript client
- Updated the documentation navigation to include the new Azure AD guide
- Created a changeset to document the addition of the Azure AD guide and
specify a minor version bump



___



### **Changes walkthrough** 📝
<table><thead><tr><th></th><th align="left">Relevant
files</th></tr></thead><tbody><tr><td><strong>Documentation</strong></td><td><table>
<tr>
  <td>
    <details>
<summary><strong>quiet-geckos-juggle.md</strong><dd><code>Add changeset
for Azure AD guide</code>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
</dd></summary>
<hr>

.changeset/quiet-geckos-juggle.md

<li>Added a new changeset file for documenting the addition of Azure AD
<br>guide<br> <li> Specified a minor version bump for '@nhost/docs'
package<br>


</details>


  </td>
<td><a
href="https://github.com/nhost/nhost/pull/2915/files#diff-2c7db1bbd9a097cc4cc00cd3cf2c0609990a73d356d72adcf68f98f903cf6019">+5/-0</a>&nbsp;
&nbsp; &nbsp; </td>

</tr>                    

<tr>
  <td>
    <details>
<summary><strong>sign-in-azuread.mdx</strong><dd><code>Add Azure AD
sign-in guide</code>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
&nbsp; &nbsp; &nbsp; &nbsp; </dd></summary>
<hr>

docs/guides/auth/social/sign-in-azuread.mdx

<li>Created a new guide for signing in with Azure AD<br> <li> Provided
step-by-step instructions for setting up Azure AD<br> <li> Explained how
to configure Nhost for Azure AD integration<br> <li> Included code
snippet for user sign-in using Nhost JavaScript client<br>


</details>


  </td>
<td><a
href="https://github.com/nhost/nhost/pull/2915/files#diff-a330d3942593fc968c6fd909dda5b287ea31a759434045a71b8b7ec797419cb7">+47/-0</a>&nbsp;
&nbsp; </td>

</tr>                    
</table></td></tr><tr><td><strong>Configuration
changes</strong></td><td><table>
<tr>
  <td>
    <details>
<summary><strong>mint.json</strong><dd><code>Update navigation to
include Azure AD guide</code>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </dd></summary>
<hr>

docs/mint.json

<li>Added 'sign-in-azuread' to the list of pages under the "Social Sign
<br>In" group<br>


</details>


  </td>
<td><a
href="https://github.com/nhost/nhost/pull/2915/files#diff-c91a604899dfef4b2494c317f4fd39a7f22b79986095f580399347293d534deb">+1/-0</a>&nbsp;
&nbsp; &nbsp; </td>

</tr>                    
</table></td></tr></tr></tbody></table>

___

> 💡 **PR-Agent usage**: Comment `/help "your question"` on any pull
request to receive relevant information

.changeset/quiet-geckos-juggle.md

@@ -0,0 +1,5 @@
+---
+'@nhost/docs': minor
+---
+
+feat: added azuread's guide

docs/guides/auth/social/sign-in-azuread.mdx

@@ -0,0 +1,47 @@
+---
+title: Sign In with Azure
+description: Follow this guide to sign in users with Azure.
+icon: microsoft
+---
+
+## Set up Azure AD
+
+1. Visit the Azure Portal and create an account if needed.
+2. Navigate to "Microsoft Entra ID".
+3. Under "Manage", select "App Registrations".
+4. Click "+ New Registration" and fill out the form:
+   * Name: Choose a descriptive name
+   * Supported Account Type: Select based on your needs
+   * Redirect URI: Choose "Web" and enter your Auth service's callback URL (e.g., https://<subdomain>.auth.<region>.nhost.run/v1/signin/provider/azuread/callback)
+   * Click "Register"
+
+<Note>
+Find the Redirect URL in your project settings -> Sign In Methods after enabling Azure AD.
+</Note>
+
+5. Copy the "Application (client) ID" for later use.
+6. Create a new client secret:
+   * Click "Add a certificate or secret"
+   * Select "New client secret"
+   * Set a description and expiration time
+   * Copy the secret's "Value" (not the ID)
+
+## Configure Nhost
+
+1. Go to your project's settings -> Sign In Methods.
+2. Find Azure AD, enable it, and enter the client ID and secret.
+3. Save your changes.
+
+## User Sign-In
+
+Use the [Nhost JavaScript client](/reference/javascript) to sign in users:
+
+```js
+nhost.auth.signIn({
+  provider: 'azuread'
+})
+```
+
+<Note>
+To use your own domain for the callback URL refer to the [custom domains](/platform/custom-domains) documentation.
+</Note>

docs/mint.json

@@ -140,6 +140,7 @@
           "icon": "at",
           "pages": [
             "guides/auth/social/sign-in-apple",
+            "guides/auth/social/sign-in-azuread",
             "guides/auth/social/sign-in-discord",
             "guides/auth/social/sign-in-facebook",
             "guides/auth/social/sign-in-github",