Introduction
This guide will show you how to access and manage Knowledge Base (KB) administration in Easy8. This is useful for managing the connection between Easy8 and KB, configuring authentication, and resolving potential sync issues. By following these steps, you’ll be able to maintain proper KB functionality and troubleshoot user access.
Target Audience
- Administrator
Prerequisites
- Access to the Administration section in Easy8
- KB plugin installed and active
- Basic understanding of OAuth2 and SSO concepts
How to Administer Knowledge Base in Easy8
Step 1: Access Knowledge Base Administration
- Go to Administration
- Navigate to Plugins
- Select Knowledge Base - Edit
This section allows you to configure key components related to KB operation.
Step 2: Configure BS OAuth2 Provider Settings for API
- This setting handles the general connection between Easy8 and KB.
- In Cloud environments, this is done automatically.
- Click the Check button to verify the connection.
Important: Always use the Check button after making any changes or if the KB does not behave as expected (e.g., KB search not returning results).
Step 3: Review Easy OAuth2 Provider Settings for SSO
- This manages Single Sign-On (SSO) between Easy8 and KB.
- SSO is generated automatically for both Cloud and Server environments.
- Use this section to help debug access issues from Easy8 to KB.
Step 4: Use “Update Permissions on BS for All Users” (Only When Needed)
- This button is only for emergency use.
- Normally, permissions are updated automatically.
- Example: If you lower a user's KB access level, the change may take up to an hour to apply. Use this button if you want the update to take effect immediately.
Troubleshooting
| Issue | Solution |
|---|---|
| KB search does not return results | Use the Check button in the BS OAuth2 settings to verify the connection. |
| User cannot access KB despite proper permissions | Use the SSO settings to inspect and debug access problems. |
| Permission change not applied immediately | Click Update permissions on BS for all users to apply changes right away. |
Conclusion
You have successfully learned how to administer the Knowledge Base plugin in Easy8, including connection validation, SSO debugging, and permission synchronization.
