Drupal Setup
Before the connector can traverse content from Drupal, the source system must be properly configured.
Drupal User and Permissions
The Drupal Connector supports Basic Authentication. Ensure the following modules are installed and enabled:
-
JSON:API Module Exposes JSON-based endpoints for accessing Drupal content. JSON:API Module Documentation
-
Serialization Module Provides services for serializing and deserializing data (e.g., to/from JSON). Serialization Module Documentation
-
HTTP Basic Auth Module Enables HTTP Basic Authentication on Drupal API endpoints. HTTP Basic Auth Module Documentation
For installation instructions, see: Installing Modules in Drupal.
Configure the Technical Account
To ensure secure, minimal access, create a dedicated technical role and user:
-
Create a Custom Role
-
In the Drupal admin UI, navigate to People → Roles.
-
Click + Add role and enter a name (e.g., ConnectorTechnicalRole).
-
Save the role.
-
Edit the role’s permissions to enable Access content for all content types the connector indexes (e.g., nodes, articles, taxonomy terms, and comments if required).
-
For detailed instructions on creating a new role, see: Creating a New Role.
-
Create the Technical User
-
In the Drupal admin UI, navigate to People → + Add user.
-
Enter the required details (username, email, password); for example, use “connector_crawl_user”.
-
Under Roles, assign the custom role (e.g., ConnectorTechnicalRole).
-
Save the account.
-
For detailed guidance, see: Creating a Drupal User Account.
Connector Permissions
Ensure the technical account has the following key permissions:
| Permission Name | Description |
|---|---|
Access content |
Allows viewing published content via JSON:API. Enable for all content types the connector indexes. |
Access JSON:API endpoints |
Automatically available with the JSON:API module. |
View user email addresses |
Enable if email indexing is required. |
| Adjust permissions as necessary. Always configure via the official Drupal Permissions Guide. |
(Optional) TLS/SSL Certificates
If your Drupal site uses a self-signed or custom SSL certificate: • Import the certificate into the connector’s Java Keystore to avoid SSL handshake issues. • For guidance, refer to Java Keystore Documentation.