Skip to content

Latest commit

 

History

History
29 lines (18 loc) · 1.09 KB

0005-use-a-guid-as-installation-id.md

File metadata and controls

29 lines (18 loc) · 1.09 KB

5. Use a GUID as Installation ID

Date: 2018-04-27

Status

Accepted

Context

When adding a new installation in the Notification Hub an Installation ID has to be provided by the App. Notification Hub says nothing about the format of this field, just that it is a string. Complete documentation can be found here.

Decision

We decided to enforce the type of the Installation ID field to be a canonical GUID as described here. We suggest to use the version 4.

The sixteen octets of an Installation ID are represented as 32 hexadecimal (base 16) digits, displayed in five groups separated by hyphens, in the form 8-4-4-4-12 for a total of 36 characters (32 alphanumeric characters and four hyphens).

For example: 123e4567-e89b-12d3-a456-426655440000

Consequences

Client App MUST generate an unique identifier following this format or the installation will not be accepted by the proxy.