package identity

import "github.com/docker/swarmkit/identity"

Package identity provides functionality for generating and manager identifiers within swarm. This includes entity identification, such as that of Service, Task and Network but also cryptographically-secure Node identity.

Random Identifiers

Identifiers provided by this package are cryptographically-strong, random 128 bit numbers encoded in Base36. This method is preferred over UUID4 since it requires less storage and leverages the full 128 bits of entropy.

Generating an identifier is simple. Simply call the `NewID` function, check the error and proceed:

id, err := NewID()
if err != nil { /* ... handle it, please ... */ }

Index ¶

• func NewID() string

Functions ¶

func NewID ¶

func NewID() string

NewID generates a new identifier for use where random identifiers with low collision probability are required.

With the parameters in this package, the generated identifier will provide 128 bits of entropy encoded with base36. Leading padding is added if the string is less 25 bytes. We do not intend to maintain this interface, so identifiers should be treated opaquely.

Source Files ¶

doc.go randomid.go