Enabling security

Security configurations in the GraphDB Workbench are located under Setup ‣ Users and Access.

The Users and Access page allows you to create new users, edit the profiles, change their password and read/write permissions for each repository, as well as delete them.

Note

As a security precaution, you cannot delete or rename the admin user.

_images/users_and_access.png

By default, the security for the entire Workbench instance is disabled. This means that everyone has full access to the repositories and the admin functionality.

To enable security, click the Security slider on the top right. You are immediately taken to the login screen.

Login and default credentials

_images/login.png

The default admin credentials are:

username: admin
password: root

Note

We recommend changing the default credentials for the admin account as soon as possible. Using the default password in production is not secure.

Free access

Once you have enabled security, you can turn on free access mode. If you click the slider associated with it, you will be shown this pop-up box:

_images/Free_access_configuration.png

This gives you the ability to allow unrestricted access to a number of resources without the need of any authentication. This is useful when creating a public SPARQL endpoint.

In the example above, all users will be able to read and write in the “employees” repository and only read the “inventory” repository. They will also be able to create or delete connectors and toggle plugins for the “employees” repository. If either of these two repositories had an additional check in the third column (“GraphQL only rights”), then that access would only be available via the GraphQL interface. (See this documentation’s GraphQL section for more information on GraphDB’s support for this query language.)

The Workbench settings described in Customizing Workbench behavior let you configure the default behavior for the GraphDB Workbench. Here, you can enable or disable the following:

  • Default sameAs value — This is the default value for the Expand results over owl:sameAs option in the SPARQL editor. It is taken each time a new tab is created. Note that once you toggle the value in the editor, the changed value is saved in your browser, so the default is used only for new tabs. The setting is also reflected in the Graph settings panel of the Visual graph.

  • Default Inference — Same as above, but for the Include inferred data in results option in the SPARQL editor. The setting is also reflected in the Graph settings panel of the Visual graph.

  • Count all SPARQL results — For each query without limit sent through the SPARQL editor, an additional query is sent to determine the total number of results. This value is needed both for your information and for results pagination. In some cases, you do not want this additional query to be executed, because for example the evaluation may be too slow for your data set. Set this option to false in this case.

Configure default security behavior

By default, any user with admin credentials can enable or disable security at will without reauthentication. However, security in GraphDB can also be set via the property graphdb.auth.security.enabled. When security is enabled or disabled this way, administrators will be unable to change the security configurations of GraphDB.

This property takes the following values:

  • Unset — by default, graphdb.auth.security.enabled is unset. The default GraphDB behavior is preserved, and users with admin access will be able to change GraphDB’s security configurations.

  • true — security is always enabled and cannot be disabled by users with administrator access.

  • false — security is always disabled and cannot be enabled by users with administrator access.