WIP Managed Identity Stuff

Author: ProbablePrime

articles/communication-services/quickstarts/includes/managed-identity-js.md

@@ -1,9 +1,7 @@
-## Prerequisites
-
-- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+## Additional Prerequisites for Java
+For Java, you'll also need:
 - [Java Development Kit (JDK)](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install) version 8 or above.
 - [Apache Maven](https://maven.apache.org/download.cgi).
-- A deployed Communication Services resource and connection string. [Create a Communication Services resource](../create-communication-resource.md).
 
 ## Add managed identity to your Communication Services solution (Java)
 

articles/communication-services/quickstarts/includes/managed-identity-net.md

@@ -0,0 +1,160 @@
+## Setting Up
+
+### Create a new Node.js Application
+
+Open your terminal or command window create a new directory for your app, and navigate to it.
+
+```console
+mkdir managed-identity-quickstart && cd managed-identity--quickstart
+```
+
+Run `npm init -y` to create a **package.json** file with default settings.
+
+```console
+npm init -y
+```
+
+### Install the SDK packages
+
+```console
+npm install @azure/communication-identity
+npm install @azure/communication-common
+npm install @azure/communication-sms
+npm install @azure/identity
+```
+
+### Create a new file
+
+Open a new file with a text editor and save it as `index.js`, we'll be placing our code inside this file.
+
+### Use the SDK packages
+
+Add the following `require` directives to the top of `index.js` to use the Azure Identity and Azure Storage SDKs.
+
+```JavaScript
+const { DefaultAzureCredential } = require("@azure/identity");
+const { CommunicationIdentityClient, CommunicationUserToken } = require("@azure/communication-identity");
+const { SmsClient, SmsSendRequest } = require("@azure/communication-sms");
+```
+## Create a DefaultAzureCredential
+
+We'll be using the [DefaultAzureCredential](/javascript/api/@azure/identity/defaultazurecredential) for this quickstart. This credential is suitable for production and development environments. As it is needed for each operation let's create it within the top of our `index.js` file. 
+
+```JavaScript
+    const credential = new DefaultAzureCredential();
+```
+
+## Create an identity and issue a token with Managed Identity
+
+Next, we'll write a function which creates a new identity and issues a token for this identity, we'll use this later to test our managed identity setup.
+
+```JavaScript
+async function createIdentityAndIssueToken(resourceEndpoint) {
+    const client = new CommunicationIdentityClient(resourceEndpoint, credential);
+    return await client.createUserAndToken(["chat"]);
+}
+```
+
+## Send an SMS with Managed Identity
+
+Now, lets write a function which uses managed identities to send an SMS:
+
+```JavaScript
+async function sendSms(resourceEndpoint, fromNumber, toNumber, message) {
+    const smsClient = new SmsClient(resourceEndpoint, credential);
+    const sendRequest = {
+        from: fromNumber,
+        to: [toNumber],
+        message: message
+    };
+    return await smsClient.send(
+        sendRequest,
+        {} //Optional SendOptions
+    );
+}
+```
+
+## Write the main method
+
+With our functions created we can now write a main function to call them and demonstrate the use of Managed Identities:
+```JavaScript
+async function main() {
+    // You can find your endpoint and access key from your resource in the Azure portal
+    // e.g. "https://<RESOURCE_NAME>.communication.azure.com";
+    endpoint = "https://<RESOURCE_NAME>.communication.azure.com/"
+
+    
+    console.log("Retrieving new Access Token, using Managed Identities");
+    const result = await createIdentityAndIssueToken(endpoint);
+    console.log(`Retrieved Access Token: ${result.token}`);
+
+    console.log("Sending SMS using Managed Identities");
+
+    // You will need a phone number from your resource to send an SMS.
+    const smsResult = await sendSms(endpoint, "<FROM NUMBER>", "<TO NUMBER>", "Hello from Managed Identities");
+    console.log(`SMS ID: ${smsResult[0].messageId}`);
+    console.log(`Send Result Successful: ${smsResult[0].successful}`);
+}
+
+main();
+```
+
+The final `index.js` file should look like this:
+```JavaScript
+const { DefaultAzureCredential } = require("@azure/identity");
+const { CommunicationIdentityClient, CommunicationUserToken } = require("@azure/communication-identity");
+const { SmsClient, SmsSendRequest } = require("@azure/communication-sms");
+
+const credential = new DefaultAzureCredential();
+
+async function createIdentityAndIssueToken(resourceEndpoint) {
+    const client = new CommunicationIdentityClient(resourceEndpoint, credential);
+    return await client.createUserAndToken(["chat"]);
+}
+
+async function sendSms(resourceEndpoint, fromNumber, toNumber, message) {
+    const smsClient = new SmsClient(resourceEndpoint, credential);
+    const sendRequest = {
+        from: fromNumber,
+        to: [toNumber],
+        message: message
+    };
+    return await smsClient.send(
+        sendRequest,
+        {} //Optional SendOptions
+    );
+}
+
+async function main() {
+    // You can find your endpoint and access key from your resource in the Azure portal
+    // e.g. "https://<RESOURCE_NAME>.communication.azure.com";
+    endpoint = "https://<RESOURCE_NAME>.communication.azure.com/"
+
+    
+    console.log("Retrieving new Access Token, using Managed Identities");
+    const result = await createIdentityAndIssueToken(endpoint);
+    console.log(`Retrieved Access Token: ${result.token}`);
+
+    console.log("Sending SMS using Managed Identities");
+
+    // You will need a phone number from your resource to send an SMS.
+    const smsResult = await sendSms(endpoint, "<FROM NUMBER>", "<TO NUMBER>", "Hello from Managed Identities");
+    console.log(`SMS ID: ${smsResult[0].messageId}`);
+    console.log(`Send Result Successful: ${smsResult[0].successful}`);
+}
+
+main();
+```
+
+## Run the Program
+
+With everything complete, you can run the file by entering `node index.js` from your project's directory. If everything went well you should see something similar to the following.
+
+```Bash
+    $ node index.js
+    Retrieving new Access Token, using Managed Identities
+    Retrieved Access Token: ey...Q
+    Sending SMS using Managed Identities
+    SMS ID: Outgoing_2021040602194...._noam
+    Send Result Successful: true
+```