Socket
Socket
Sign inDemoInstall

@azure-tools/communication-alpha-ids

Package Overview
Dependencies
10
Maintainers
1
Versions
78
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@azure-tools/communication-alpha-ids

SDK for Azure Communication Services which facilitates Alpha IDs administration.


Version published
Maintainers
1
Created

Readme

Source

Azure Communication Alpha IDs client library for JavaScript

The Alpha IDs library provides capabilities for Alpha IDs administration.

Getting started

Prerequisites

  • An Azure subscription.
  • An existing Communication Services resource. If you need to create the resource, you can use the Azure Portal, the Azure PowerShell, or the Azure CLI.

Installing

npm install @azure-tools/communication-alpha-ids

Browser support

JavaScript Bundle

To use this client library in the browser, first you need to use a bundler. For details on how to do this, please refer to our bundling documentation.

Key concepts

Examples

Authentication

To create a client object to access the Communication Services API, you will need a connection string or the endpoint of your Communication Services resource and a credential. The Alpha IDs client can use either Azure Active Directory credentials or an API key credential to authenticate.

You can get a key and/or connection string from your Communication Services resource in the Azure Portal. You can also find the endpoint for your Communication Services resource in the Azure Portal.

Once you have a key, you can authenticate the AlphaIdsClient with any of the following methods:

Using a connection string

const { AlphaIdsClient } = require("@azure-tools/communication-alpha-ids");

const connectionString = "endpoint=<endpoint>;accessKey=<accessKey>";
const client = new AlphaIdsClient(connectionString);

Using an access key with AzureKeyCredential

If you use a key to initialize the client you will also need to provide the appropriate endpoint. You can get this endpoint from your Communication Services resource in Azure Portal. Once you have a key and endpoint, you can authenticate with the following code:

const { AzureKeyCredential } = require("@azure/core-auth");
const { AlphaIdsClient } = require("@azure-tools/communication-alpha-ids");

const credential = new AzureKeyCredential("<key-from-resource>");
const client = new AlphaIdsClient("<endpoint-from-resource>", credential);

Using an Azure Active Directory Credential

Connection string authentication is used in most of the examples, but you can also authenticate with Azure Active Directory using the Azure Identity library. To use the DefaultAzureCredential provider shown below, or other credential providers provided with the Azure SDK, please install the @azure/identity package:

npm install @azure/identity

The @azure/identity package provides a variety of credential types that your application can use to do this. The README for @azure/identity provides more details and samples to get you started.

const { DefaultAzureCredential } = require ("@azure/identity");
const { AlphaIdsClient } = require("@azure-tools/communication-alpha-ids");

let credential = new DefaultAzureCredential();
const client = new AlphaIdsClient("<endpoint-from-resource>", credential);

Usage

The following sections provide code snippets that cover some of the common tasks using the Azure Communication Services Alpha IDs client. The scenarios that are covered here consist of:

Get the current applied configuration

Use the getConfiguration method to obtain the current applied configuration for your resource.

const { AlphaIdsClient } = require("@azure-tools/communication-alpha-ids");

const connectionString = "endpoint=<endpoint>;accessKey=<accessKey>";
const client = new AlphaIdsClient(connectionString);

// get the current configuration
var configuration = await client.getConfiguration();

console.log(`Usage of Alpha IDs is currently ${(configuration.enabled ? "enabled" : "disabled")}`);

Troubleshooting

Next steps

Please take a look at the samples directory for detailed examples on how to use this library.

Contributing

If you'd like to contribute to this library, please read the contributing guide to learn more about how to build and test the code.

Impressions

Keywords

FAQs

Last updated on 22 Sep 2022

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc