# User guide

# Introduction

The primary target audience for this guide is personnel in charge of certificates in inspection laboratories. The secondary target is staff from business process design and information technology departments.

# User and company registration

# Register new user

The first step is to register an user account with username, email, and password, which the user has to confirm by a link received via email.

Register new user

# Register company

After a user has confirmed its email address, its company has to be registered on the platform. Currently, the value-added tax identification number issued by the countries of the European Union serves as a unique identifier. After entering the VAT ID, it is validated and the company data from the services provided by the European Union.

Register company

With an entry into other markets, additional identifiers, such as the DUNS number issued by Dun&Bradstreet and the CAGE Code common in the aviation industry, would be needed.

# Setup of a wallet and identities

# Introduction

Interactions with Blockchain require cryptographic keys, specifically one or more pairs of private and public keys. S1Seven provides a cloud wallet solution to create and store private keys in highly secure wallets guaranteeing that private keys never leave cryptographically secure zones.

# Setup of a wallet

For a start, a wallet can be created from scratch or from a backup which works basically the same way. So, the first step is to select “Create new wallet”.

Add a wallet

The second step is to give a name.

Name the wallet

The third step is that the user has to confirm that they have taken all recommended measures to keep the mnemonic seed presented in the next step confidential and safely stored.

Confirm security measures

In the next step, the words of the mnemonic seed are presented. This will be shown one time only. Please note that it is highly recommended to note down the words on paper and not take any screenshot as this poses a security risk.

Write down mnemonic seed

To confirm that the user has written all words of the mnemonic seed it has to enter all of them in a random order.

Confirm mnemonic seed

After that step, the wallet is ready for use.

# Creation of identities

A pair of private and public keys are also called identities. S1Seven supports the creation of multiple key pairs via the user interface but at least one identity has to be created.

Create an identity

Identities can be used in several ways for example: Each department issuing certificates in an organization gets assigned an identity Each person signing certificates in an organization gets assigned an identity

# Notarization of certificates

# Electronic certificates formats

Certificates are electronic documents in the form of JSON files as illustrated below.

JSON file image

S1Seven supports multiple formats for certificates:

Steel mill certificates according EN 10204 / EN 10168 Plastics certificates of analysis as developed in cooperation with a leading plastics producer, which will be published as open source in 2022 Mill certificates and certificates of conformity as specified in DIN SPEC 9012

Future versions of these formats and new formats will be supported. For format specifications and further documentation, please refer to the appendix.

# Manual notarization

A JSON document can be uploaded in the user interface.

Notarize JSON

The consistency, correctness, and completeness of the file is verified. In the case of successful verification, a PDF document is created from the JSON document and both are notarized on the Blockchain.

S1Seven assumes that notarization will be automated. For this purpose, S1Seven offers an API as referenced in the appendix. Furthermore, an SAP Add.on is offered. For more information on the SAP Add.on, please get in touch with S1Seven.

# Verification of certificates

# Verify certificate in the application

S1Seven offers the verification of certificates for registered users in the platform. The user uploads the JSON or PDF document in the “Verify” section. If the document has been notarized on Blockchain the status “verified” including data about the signer and signing date are displayed.

Verify certificate in the app

If the document to be verified is a JSON certificate, it is rendered as HTML below to let the user have a quick glance at its contents.

S1Seven assumes that verification should be automated in most use cases which can be done via the API offered by S1Seven, which is referenced in the appendix.

# Verify certificate on the public verification service

S1Seven offers a service to everybody to verify a certificate received from any party in the value chain. By this, the holder of the certificate can verify the origin of the certificate and its integrity.

Verify certificate

# Create an access token

For applications or scripts that require long term access, an access token key with a one-year time limit can be created by opening the Developers section on the main page. Developers section Then click on Generate new token and chose the scopes (actions) that this token will grant access to, and add a name in the Token description input field. Then click Save. Generate new token You will then have the opportunity to copy the access token.

WARNING

You will only see this once, so be sure to copy it before clicking Close.

Copy the access token You can see that your newly created access token has been added to the list of access tokens. If you ever need to revoke the access token, you can simply delete it using the Delete button. See token list

# Register webhook notifications

Webhooks allow external services to be notified when certain events happen. We’ll send a POST request to each of the URLs you provide. To set up a webhook, open the Developers section and click on Webhooks. Webhooks section

Click on Add webhook, add a Payload URL, Secret, choose a mode, and choose the events that will trigger the webhooks. Add a new webhook

TIP

This secret is used to sign the payload and allows you to verify that S1Seven is the one sending the request.

Then click Save, and you will see your webhook has been added to the list of webhooks. See list of webhooks

For further details, please take a look at our developer documentation (opens new window)

# Register mail notifications

Mailhooks trigger emails on certain events. We send you an email with data on the event. To set up a webhook, open the Developers section and click on Mailhooks. Add a Recipient email address, choose the mode, and choose the events that will trigger the mailhooks. Add a mailhook

Then click Save, and you will see your mailhook has been added to the list of mailhooks. See list of mailhooks