How to get an account and log in to LinkedDataHub
\nIn order to authenticate as the owner of a LinkedDataHub instance, you need to use the WebID authentication method.
\nGet certificate
\nLinkedDataHub uses WebID as the Single sign-on (SSO)\n protocol for distributed applications, which is based on authentication using TLS client certificates. Using WebID, you will be able to authenticate with every LinkedDataHub dataspace.\n Read more about WebID.
\nThere are two ways to get a LinkedDataHub WebID: run your own instance or sign up to an existing one.
\nRun your own instance
\nComplete the setup to run your own instance of LinkedDataHub.
\nThe ssl/owner/keystore.p12 file is your WebID certificate. The password is the owner_cert_password Docker secret value.
\nSign up to an existing instance
\nClick the Sign up button and fill out the form with your details to get a WebID, as shown below.
\n![\"The](\"/uploads/a9b5df4541a4b73c3c9764e6b4d8bf4918df1961\")
\n You will get an email with a .p12 file attached, which is your WebID certificate. The certificate's password is the one you entered in the signup form.
\nThe command line interface reads the PKCS12 (.p12) file directly — no conversion needed. Setup writes it to ssl/owner/keystore.p12.
\ncurl needs a PEM version instead. Setup writes that too, to ssl/owner/cert.pem. A certificate received by email can be converted from PKCS12 to PEM with OpenSSL:
\nopenssl pkcs12 -in cert.p12 -out cert.pem -nodes\n
Unlike most LinkedDataHub resources, your WebID profile will have public access as required by the protocol. Your email address, however, stays hidden.
\nInstall certificate
\nThe final step is to install the client certificate into your web browser. Import the .p12 file with\n your browser's certificate manager, using the certificate's password (from signup, or the owner_cert_password\n secret if you ran setup). Open the manager dialog following the steps below, depending on which browser you use:
\n- \n
- Google Chrome \n
- Settings > Advanced > Manage Certificates > Import... \n
- Mozilla Firefox \n
- Options > Privacy & Security > View Certificates... > Import... \n
- Apple Safari \n
- The file is installed directly into the operating system. Open the file and import it using the\n Keychain Access\n tool. Drag the .p12 file to the login section. \n
- Microsoft Edge \n
- Edge has no certificate manager of its own — install the file into the Windows certificate store.\n Read more here. \n
You need to install the certificate on all devices/browsers that you are using to access LinkedDataHub.
\nLog in
\nOpen the LinkedDataHub instance in the browser you installed the certificate into. Using a local setup, it runs on https://localhost:4443/ by default.
\nWith the certificate installed, there is no login procedure — you are automatically authenticated on all\n LinkedDataHub dataspaces. This is known as Single sign-on (SSO).
\nDataspaces may make some or all of their documents public; you can browse those without authenticating. To reach\n protected (non-public) resources, or the administration dataspace, you have to be authenticated and\n authorized (authorizations can be requested).
\nAuthenticated agents are not guaranteed to have access to all resources. Different access levels for\n different agents can be specified by the dataspace administrators.
\nOpen the Login expand_more dropdown in the navigation bar and choose Login with Google to authenticate with your Google account.
\nIf the email address of your Google account matches the dataspace owner's email address that was specified during setup, you will be authenticated as the owner with full control access rights.
\nLogin with Google is only enabled if LinkedDataHub was configured with social login.
\nOpen the Login expand_more dropdown in the navigation bar and choose Login with ORCID to authenticate with your ORCID account using OpenID Connect.
\nIf the email address of your ORCID account matches the dataspace owner's email address that was specified during setup, you will be authenticated as the owner with full control access rights.
\nLogin with ORCID is only enabled if LinkedDataHub was configured with social login.
\nSigned in? Next, request access to the documents you need.
\n