Secure Endpoint with Basic Auth¶
A secured endpoint is when there are access-protected resources. You have to specify the username and the password when a request is sent to a secured endpoint. The endpoint authentication mechanism can either be Basic Authentication or Digest Authentication. They differ on how the credentials are communicated and how access is granted by the backend server.
Basic Authentication is the simplest mechanism used to enforce access controls to web resources. Here, the HTTP user agent provides the username and the password when making a request. The string containing the username and the password separated by a colon is Base64 encoded and sent in the authorization header when calling the backend when authentication is required.
Info
If the user name and password is admin, the following header will be sent to the backend.
Authorization: Basic YWRtaW46YWRtaW4=` (where `YWRtaW46YWRtaW4=` is equivalent to Base64Encoded{admin:admin} )
When you create an API using the API Publisher, you can specify the endpoints of the API backend implementation via the Endpoints page as Production and Sandbox endpoints respectively.
Follow the instructions below to use Basic Auth as the endpoint authentication type when using a secured endpoint:
-
Click Endpoints in API Publisher.
-
Click the Endpoint Security symbol of the endpoint that you want to secure with Basic Auth.
-
Select Basic Auth as the endpoint authentication type from the drop-down menu.
-
After entering your credentials, click Submit to confirm the details of the respective endpoint and then click Save in the Endpoints page to save all the changes made in the Endpoints page.
Info
The Endpoint Auth Type selected should match with the authentication mechanism supported by the secured endpoint.