Several services are connected to B2SHARE in order to make it function smoothly. In this guide the configuration of each of these services is described.
In this guide the following services are discussed:
- B2ACCESS: use institional or social credentials for access using EUDAT's federated authentication and authorisation service
- B2HANDLE: registration and resolving of EPIC handles using EUDAT's persistent identifier service
- B2DROP: direct publication from EUDAT's data sharing and exchange service
- DOI: registration and resolving of DOI persistent identifiers
- B2NOTE: adding metadata to files using EUDAT's semantic annotation service (in pilot phase)
In this section the configuration of B2ACCESS is described.
Currently there are two instances of B2ACCESS running:
This instance can be used to test your instance. Any user registration request will be automatically granted and therefore can be immediately used.
- The production instance run by EUDAT
The production instance of B2ACCESS can only be used for production instance of B2SHARE. You registration requests will only be granted if sufficient information is provided that you need an actual production registration.
For the remaining part of this guides and all other guides, it is assumed that the B2ACCESS acceptance instance is used. For more information on B2ACCESS and its configuration, please refer to the EUDAT user documentation on B2ACCESS service integration.
To let B2SHARE automatically communicate with B2ACCESS a OAuth 2.0 Client registration is required.
- Go to the B2ACCESS acceptance instance and click on 'Register a new account' (top-right):
- Click 'OAuth 2.0 Client Registration Form' and fill in a user name, passwords, security question answers and your email address:
- Carefully remember your username and password, as this will be needed later on (see below)
- Take special care for the OAuth client return URL. This needs to be your fully qualified domain name (FQDN) plus the API endpoint for B2ACCESS in the B2SHARE service, e.g.:
https://my-domain.com/api/oauth/authorized/b2access/
This value can always be changed later by logging in to B2ACCESS again with the newly created credentials.
- Upon successfull registration, you will see the following overview:
Once you've successfully set up B2ACCESS, you can continue with the registration of a administrative user that will be able to configure B2ACCESS.
Refer to the User management guide on how to register a new user in B2ACCESS.
In this section the configuration of B2HANDLE is described.
In this section the configuration of B2DROP is described.
In this section the configuration of the Digital Object Identifier (DOI) service is described. With this service new DOIs can be minted, administered and resolved.
In this section the configuration of B2NOTE is described.