Getting Started

OAUTH_URL
https://partnersolutionsconnectproxy.verizon.com:443/oauth/
client_credential/accesstoken?grant_type=client_credentials

OAuth 2.0 is the industry-standard protocol for authentication and authorization. All Verizon APIs are protected by OAuth 2.0.

1) Obtain the client credentials by subscribing to the API

Client applications need Client ID and Client Secret to obtain the oAuth 2.0 access token. To obtain the client credentials , go to the 'Develop' tab click on the "Subscribe Now" button to subscribe to an API.Once the subsription has been approved,click on the subscription name to obtain the client key and secret.Separate client credentials are provided for test and production environment.

For the production environment,the Client ID and Secret are provided only to the Company Admin.

2) Obtain the accessToken.

Before the client application can access Verizon APIs , it must obtain an access token that grants access to that API.To obtain the access token, call the acess token POST URL 'OAUTH_URL' by sending the Client ID & Secret in the HTTP basic authentication header. The body of this request should be set to 'grant_type=client_credentials'.

3) Invoke the API.

Once the access token is obtained, invoke the API call with the accesstoken set in the HTTP authorization header.

4) Refresh the accesstoken.

Access tokens have limited lifetimes. The access token Verizon issues are valid for 60 minutes. If the client applications needs invoke the API beyond the lifetime of a single access token, a new access token is to be obtained. Invoke the access token URL every 55 mins to get a new token.

OAuth Access Workflow

2-WaySSL

Once the contract is signed, Please subscribe to the available API’s. All the APIs in the verizon follows 2-Way SSL. To consume the APIs please send a valid Certificate to the Connectivity Management team Via email (connectivity.management.team@one.verizon.com).

How 2-WaySSL works?
The client should get and provide certificate to verizon on their own. These certificates are then stored in the Edge TLS Keystores. On every request client will be establishing the connection using the certificate shared above. Then the request goes to the TLS server and validates.(Eg: it checks for company name, user, validity,..) The API response is displayed.

Users can register for an account using the Register link in the home page as highlighted below.

Clicking on the Register Link will pop-up a window with the registration fields. Please enter the required information and select the desired user type and submit your user registration. All registrations will be reviewd by the Verizon Connectivity Management Team

Your subscription dashbord can be accessed using the My Apps link in the home page as highlighted below.

The subscription dashboard shows the existing subscriptions and the link to adding a new subscription.

Clicking on any of the existing subscription will expand the row to display the subscription details (API products in the subscription, Keys, link to edit / delete subscription).

Clicking on the New Subscription will navigate the user to the new subscriptions page where users can create a new subscription to additional APIs. As detailed in the Getting Started page, Admin users can subscribe to API products in test as well as production environment. Developers will only see test environment for subscription.