Basic

Implements HTTP Basic authentication for service-to-service communication in Grooper.

Remarks

The Basic authentication class enables Grooper to connect to external HTTP-based services that require Basic authentication. This method encodes a user name and password as a base64-encoded string and includes it in the HTTP Authorization header for each request.

Overview

Use Basic authentication when integrating with APIs or services that require credentials in the form of a user name and password. The credentials are transmitted in plain text (after base64 encoding), so it is strongly recommended to use HTTPS to protect sensitive information.

Usage

• Set the 'User Name' and 'Password' properties to the credentials required by the external service.
• When Grooper makes an HTTP request, the credentials are combined as user:password, base64-encoded, and sent as Authorization: Basic <base64-credentials>.
• Only use Basic authentication with trusted services and always over secure (HTTPS) connections.

Security Notes

• The password is stored in encrypted form and decrypted only when needed for authentication.
• Avoid using Basic authentication for highly sensitive integrations unless required by the external API.
• Never use Basic authentication over unencrypted HTTP, as credentials can be intercepted.

Example

To authenticate as user apiuser with password secret, set:

User Name: apiuser Password: secret

The resulting HTTP header will be:

Authorization: Basic YXBpdXNlcjpzZWNyZXQ=

Properties

Name	Type		Description
User Name	String	►	The user name for HTTP Basic authentication. Enter the user name required by the external service for Basic authentication. This value is combined with the 'Password' property and sent as part of the HTTP Authorization header. The user name is case-sensitive for most services. Ensure that the account has the necessary permissions for the intended API operations.
Password	String	►	The password for HTTP Basic authentication. Enter the password associated with the specified user name. The password is stored in encrypted form and decrypted only when needed for authentication. For security, avoid sharing or exposing this value. The password is combined with the user name and sent as a base64-encoded string in the HTTP Authorization header. Always use HTTPS to protect credentials in transit.

Used By

Web Service