Skip to content

Commit d2be524

Browse files
huypubhuypub
authored
Merge pull request #267114 from MicrosoftDocs/release-preview-programmable-connectivity
Release preview programmable connectivity--scheduled release at 4pm of 2/25
2 parents 613af93 + e5fef09 commit d2be524

19 files changed

+665
-0
lines changed

‎articles/programmable-connectivity/azure-programmable-connectivity-abstraction.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
title: API abstraction
3+
titleSuffix: Azure Programmable Connectivity
4+
description: Azure Programmable Connectivity (APC) abstracts away the intricacies of interacting with different network APIs
5+
author: anzaman
6+
ms.author: alzam
7+
ms.service: azure-operator-nexus
8+
ms.topic: overview
9+
ms.date: 02/16/2024
10+
ms.custom: template-overview
11+
---
12+
13+
# API Abstraction
14+
15+
Azure Programmable Connectivity (APC) provides developers with a unified standard interface that abstracts away the intricacies of interacting with different network APIs. This abstraction shields developers from the nuances of various operators and network configurations, enabling them to focus solely on building innovative applications without the burden of constantly adapting to underlying network changes.
16+
17+
With APC, developers can ensure that their code remains resilient and adaptable, even in the face of evolving network landscapes. Applications built on the APC platform maintain their functionality and performance over time, without requiring extensive rewrites or modifications due to network updates.

‎articles/programmable-connectivity/azure-programmable-connectivity-aggregation.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
title: API aggregation
3+
titleSuffix: Azure Programmable Connectivity
4+
description: Azure Programmable Connectivity simplifies the complexities associated with using Network APIs.
5+
author: anzaman
6+
ms.author: alzam
7+
ms.service: azure-operator-nexus
8+
ms.topic: overview
9+
ms.date: 02/16/2024
10+
ms.custom: template-overview
11+
---
12+
13+
# API Aggregation
14+
15+
Azure Programmable Connectivity (APC) offers a seamless Azure experience by integrating a standardized interface across diverse operator networks worldwide, effectively simplifying the complexities associated with Network APIs.
16+
17+
The APC Gateway autonomously manages API calls, credential handling, and ensures calls are accurately routed to the appropriate mobile operator.

‎articles/programmable-connectivity/azure-programmable-connectivity-billing.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
title: Azure Programmable Connectivity Billing
3+
description: Azure Programmable Connectivity provides a consolidated bill.
4+
author: anzaman
5+
ms.author: alzam
6+
ms.service: azure-operator-nexus
7+
ms.topic: overview
8+
ms.date: 02/16/2024
9+
ms.custom: template-overview
10+
---
11+
12+
# Consolidated Billing
13+
14+
By serving as a centralized marketplace, APC simplifies the procurement process while ensuring an exceptional user experience. Developers can conveniently select and subscribe to the network APIs they need without the hassle of dealing with multiple providers or complex billing systems.
15+
16+
One of the key advantages of APC is its ability to consolidate billing, enabling developers to receive a unified invoice from Azure for all their API plans, rather than managing separate bills from various operators. This streamlined approach not only reduces administrative overhead but also enhances cost transparency and efficiency in managing network resources.

‎articles/programmable-connectivity/azure-programmable-connectivity-create-gateway.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: Create an Azure Programmable Connectivity Gateway
3+
description: In this guide, learn how to create an APC gateway.
4+
author: anzaman
5+
ms.author: alzam
6+
ms.service: azure-operator-nexus
7+
ms.topic: overview
8+
ms.date: 02/08/2024
9+
ms.custom: template-overview
10+
---
11+
12+
# Quickstart: Create an APC gateway
13+
14+
In this quickstart, you learn how to create an Azure Programmable Connectivity (APC) gateway and subscribe to API plans in the Azure portal.
15+
16+
## Prerequisites
17+
18+
- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
19+
20+
### Sign in to the Azure portal
21+
22+
Sign in to the [Azure portal](https://portal.azure.com).
23+
24+
### Create a new APC gateway
25+
26+
1. In the Azure portal, Search for **APC Gateways** and then select **Create**.
27+
28+
:::image type="content" source="media/search.jpg" alt-text="Screenshot of Azure portal showing the search box." lightbox="media/search.jpg":::
29+
30+
1. Select the **Subscription**, **Resource Group** and **Region** for the gateway.
31+
32+
:::image type="content" source="media/create.jpg" alt-text="Screenshot of the create gateway page in Azure portal." lightbox="media/create.jpg":::
33+
34+
1. Provide a **Name** for the gateway and click **Next**.
35+
36+
### Select APIs
37+
38+
1. Click on the API that you want to use.
39+
1. Select the country.
40+
1. **Add** the plans you want to subscribe to.
41+
42+
:::image type="content" source="media/select.jpg" alt-text="Screenshot of the select APIs page in the Azure portal." lightbox="media/select.jpg":::
43+
44+
1. Click **Done**.
45+
1. Click **Next**.
46+
47+
### Provide application details
48+
49+
In order to use the operators API, you must provide extra details, which will be shared with the operator.
50+
51+
1. Fill out the Application name, Application description, Legal entity, Tax number and the privacy manger's email address in the text boxes.
52+
53+
:::image type="content" source="media/app-details.jpg" alt-text="Screenshot of the application details page in the Azure portal." lightbox="media/app-details.jpg":::
54+
55+
1. Click **Next**.
56+
57+
### Agree to operators' terms and conditions
58+
59+
On the **Terms and Conditions** page.
60+
61+
1. Click **Awaiting input** and then **I Agree**.
62+
63+
:::image type="content" source="media/terms.jpg" alt-text="Screenshot of the terms and conditions page in the Azure portal." lightbox="media/terms.jpg":::
64+
65+
1. Repeat the above step for each line.
66+
1. Click **Next**.
67+
68+
### Verify details and create
69+
70+
Once you see the **Validation passed** message, click **Create**.
71+
72+
:::image type="content" source="media/verify-create.jpg" alt-text="Screenshot of the verify and create page in Azure portal." lightbox="media/verify-create.jpg":::

‎articles/programmable-connectivity/azure-programmable-connectivity-locations-partners.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: Locations and partners
3+
titleSuffix: Azure Programmable Connectivity
4+
description: Azure Programmable Connectivity is a cloud service that provides a simple and uniform way for developers to access programmable networks, regardless of substrate or location.
5+
author: anzaman
6+
ms.author: alzam
7+
ms.service: azure-operator-nexus
8+
ms.topic: conceptual
9+
ms.date: 01/31/2024
10+
ms.custom: references_regions
11+
---
12+
13+
# Azure Programmable Connectivity Partners and APIs
14+
15+
## List of supported operators and APIs
16+
17+
The table in this article provides detailed information about the availability of APC.
18+
19+
| **Operator** | **Supported APIs** |
20+
| --- | --- |
21+
| Claro| Number Verify, SIM Swap |
22+
| Orange | Number Verify, SIM Swap |
23+
| Telefonica | Location, Number Verify, SIM Swap |
24+
| TIM | Location, SIM Swap |
25+
| Vivo | Location, Number Verify, SIM Swap |
26+
27+
28+
29+
Currently, APC can be deployed in the following Azure regions:
30+
31+
32+
- Brazil South
33+
- East US
34+
- Germany West Central
35+
36+
## Next steps
37+
* For more information about Azure Programmable Connectivity, see the [Overview](azure-programmable-connectivity-overview.md).

‎articles/programmable-connectivity/azure-programmable-connectivity-network-apis.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
title: What are network APIs?
3+
titleSuffix: Azure Programmable Connectivity
4+
description: Network Application Programming Interfaces (APIs) can be utilized by software developers to build applications that can communicate with the underlying network.
5+
author: anzaman
6+
ms.author: alzam
7+
ms.service: azure-operator-nexus
8+
ms.topic: overview
9+
ms.date: 01/08/2024
10+
ms.custom: template-overview
11+
---
12+
13+
# What are network APIs?
14+
15+
Network Application Programming Interfaces (APIs) can be utilized by software developers to build applications that can communicate with the underlying network. These APIs offer a uniform way for applications to access analytical and statistical data from networks, facilitating the implementation of customer experience based use cases. Network APIs can acquire network information and request configuration changes.
16+
17+
Azure Programmable Connectivity (APC) uses these network APIs to provide a unified standard interface across multiple operator networks globally while abstracting the complexities inherent to network APIs.
18+
19+
APC is now available in public preview with several APIs, including number verification, SIM swap and other capabilities.
20+
21+
:::image type="content" source="media/key-apis.jpg" alt-text="Diagram showing key network APIs." lightbox="media/key-apis.jpg":::

‎articles/programmable-connectivity/azure-programmable-connectivity-overview.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
title: What is Azure Programmable Connectivity?
3+
description: Azure Programmable Connectivity is a cloud service that provides a simple and uniform way for developers to access programmable networks, regardless of substrate or location.
4+
author: anzaman
5+
ms.author: alzam
6+
ms.service: azure-operator-nexus
7+
ms.topic: overview
8+
ms.date: 01/08/2024
9+
ms.custom: template-overview
10+
---
11+
12+
# What is Azure Programmable Connectivity?
13+
14+
Azure Programmable Connectivity (APC) is a platform that revolutionizes how developers interact with Network API services from multiple mobile operators.
15+
16+
APC ensures a smooth Azure experience by offering a single interface across different operator networks worldwide, hiding the complexities of Network APIs. This guarantees consistent and reliable code, regardless of network changes. Developers can concentrate on building apps without concerns about underlying network adjustments. With APC, networks change, but the code does not.
17+
18+
:::image type="content" source="media/apc.jpg" alt-text="Graphic showing APC architerture." lightbox="media/apc.jpg":::
19+
20+
The APC Gateway handles API calls and credentials, ensuring they're directed to the right mobile operator. Its user-friendly interface lets developers easily select and subscribe to network APIs from various operators and regions. This makes APC a convenient marketplace that streamlines procurement without sacrificing user experience.
21+
22+
APC is currently in public preview, offering various APIs such as number verification, SIM swap, and location services. Azure is working closely with global operators to incorporate their network APIs into APC, creating a robust partner network. Presently, this ecosystem includes AT&T, BT, Claro, Deutsche Telekom, Orange, Rogers, SingTel, Telefonica, T-Mobile, TIM Brasil, Verizon, and Vivo. APC is dedicated to expanding its global presence by partnering with more operators in the future.
23+
24+
To sign up for the preview, please visit https://aka.ms/apcpublicpreview.

‎articles/programmable-connectivity/azure-programmable-connectivity-security-overview.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: Overview of Security for Azure Programmable Connectivity
3+
description: Azure Programmable Connectivity is a cloud service that provides a simple and uniform way for developers to access programmable networks, regardless of substrate or location.
4+
author: anzaman
5+
ms.author: alzam
6+
ms.service: azure-operator-nexus
7+
ms.topic: overview
8+
ms.date: 01/08/2024
9+
ms.custom: template-overview
10+
---
11+
12+
# Overview of Security for Azure Programmable Connectivity
13+
14+
This article provides an overview of how encryption is used in Azure Programmable Connectivity. It covers the major areas of encryption, including encryption at rest and encryption in transit.
15+
16+
## Encryption at rest
17+
18+
Azure Programmable Connectivity (APC) stores all data at rest securely, including any temporary customer data. Azure Programmable Connectivity uses standard Azure infrastructure, with platform-managed encryption keys, to provide server-side encryption compliant with a range of security standards. For more information, see [encryption of data at rest.](../security/fundamentals/encryption-overview.md)
19+
20+
Azure Programmable Connectivity doesn't store any Customer Data or End-User Identifiable Information.
21+
22+
## Encryption in transit
23+
24+
All traffic handled by Azure Programmable Connectivity is encrypted. This encryption covers all internal communication and calls made to Operator premises.
25+
26+
HTTP traffic is encrypted using TLS, minimum version 1.2.
27+
28+
## Private connectivity
29+
30+
Currently Azure Programmable Connectivity doesn't offer the ability to call APC APIs completely within a private network. Azure Private Link integration is planned in future.
31+
32+
## Audit logging
33+
34+
There are two types of logs that are available to customers to audit their Azure Programmable Connectivity instances:
35+
- Management logs
36+
- Data plane logs
37+
38+
Management logs are the logs of management operations performed on Azure resources such as creation or deletion of APC gateway instances, adding new Operator API Connections and other.
39+
To review actions performed on these resources, go to the corresponding resource page in Azure and select 'Activity log' in the left menu.
40+
41+
Data plane logs are the logs of actions that happen when any calls are made to the APC Gateway API, such as 'sim-swap:verify'. To request these logs a support request needs to be raised. Follow the standard Azure support flow selecting the gateway, which has the logs of interest. Choose 'Using Network APIs' for problem type, and 'Calling APIs' for problem sub-type. In the problem description, indicate that you'd like to request data plane audit logs.

0 commit comments

Comments
 (0)