Basic Authentication

Implements Basic HTTP Authentication for connecting to external content platforms in Grooper.

Remarks

Basic Authentication enables Grooper to authenticate HTTP requests using a user name and password, following the RFC-7617 standard. This method is widely supported by web servers and services, and is commonly used for simple authentication scenarios where credentials are exchanged directly with the server.

Overview

When Basic Authentication is selected as the authentication method for a CMIS Binding or Custom Binding, Grooper will include the specified user name and password in the Authorization header of each HTTP request. The credentials are encoded using Base64 and transmitted over the network. For security, it is strongly recommended to use HTTPS when connecting to servers with Basic Authentication, as credentials are only obfuscated, not encrypted, by the protocol.

This method is suitable for environments where simple, direct authentication is sufficient, or where more advanced authentication mechanisms (such as OAuth or Windows Integrated Authentication) are not required or supported.

Usage Notes

• Configure the 'User Name' and 'Password' properties with the credentials required by the target server.
• Use Basic Authentication only with trusted servers and over secure (HTTPS) connections to protect sensitive information.
• If the server requires multi-factor authentication or other advanced security features, consider using a different authentication method.

Example

// Pseudocode for configuring a binding with basic authentication var binding = new MyCustomBinding(); binding.AuthMethod = new BasicAuthentication { UserName = "myuser", Password = "mypassword" };

After configuration, Grooper will use the provided credentials for all HTTP requests made by the binding.

For more information on authentication options and security best practices, see the Grooper documentation on CMIS+ connections and authentication methods.

Properties

Name	Type		Description
User Name	String	►	The user name to be used for authentication. The 'User Name' property specifies the account identifier that Grooper will use when authenticating with the target server using Basic Authentication. Enter the user name exactly as required by the server or service you are connecting to. This may be a simple name (e.g., jdoe), an email address (e.g., user@example.com), or a domain-qualified name (e.g., DOMAIN\user), depending on the server's requirements. Ensure that the user account has the necessary permissions to access the desired resources. Incorrect or missing user names will result in authentication failures.
Password	String	►	The password to be used for authentication. The 'Password' property specifies the secret credential associated with the 'User Name' for Basic Authentication. This value is securely stored in an encrypted form within Grooper, but is transmitted to the server as part of the HTTP Authorization header (Base64-encoded) when making requests. For security, always use strong, unique passwords and ensure that connections are made over HTTPS to prevent interception of credentials. If the password is changed on the server, be sure to update this property in Grooper to maintain connectivity.

Used By

ExchangeSharePointWeb Service Lookup