Users

A user is typically a person who requires access to and within your installation. This service is responsible for managing user resources such as keys, as well as their association with access rights.

name string

Resource name of the user. It must have the format of installations/*/users/*. For example: installations/surelock-homes-hq/users/john-watson.

given_name string

The personal name, forename or given name ("first name"). It could also contain a middle name. First name is not used because the given name is not placed first in some cultures.

display_name string

The display name of the user, formed by concatenating the first and last name values.

activate_time timestamp

Activation time independent of any time zone or calendar.

expire_time timestamp

Expiration time independent of any time zone or calendar.

photo_uri string

The URI to view the user photo.

card_key CardKey

The card key resource that belongs to the user.

app_key AppKey

The app key resource that belongs to the user.

wallet_key WalletKey

The wallet key resource that belongs to the user.

passcode Passcode

The passcode resource that belongs to the user.

blocked boolean

Indicates whether this user is blocked or not. A blocked user cannot perform any admin actions, that is, if they have a management role this will no longer be valid. If the user has a key then it will no longer unlock access points.

parent string

The name of the parent user of this user. Only users who have had keys shared with them will have this field set.

family_name string

The surname or family name ("last name"). It could also contain more than one surname so that both matrilineal and patrilineal surnames can be included in one place. Last name is not used because the family name is not placed last in some cultures.

email string

Email address.

photo string

The file resource name for the user photo. It must have the format of installations/surelock-homes-hq/files/01DSYSJ1PR36VVC3MRFRV4DC7G.

name string

Resource name of the user's access right association. It must have the format of installations/*/users/*/access-rights/*. For example: installations/surelock-homes-hq/users/john-watson/access-rights/baskerville.

access_right string

The access right resource name to bind as an association to the parent access point. For example: installations/surelock-homes-hq/access-rights/baskerville.

display_name string

Display name of the associated entity. In this case an access right.

schedules array of Schedule objects

The schedules for the user's access right. If set, this can only be more restrictive than the schedules defined in the associated access right.

effective_schedules array of Schedule objects

The computed effective schedules for the user's access right based on the given parent resource.

activate_time timestamp

Activation time independent of any time zone or calendar. User access right's association activation time rules: 1. Activation time must be specified in multiples of 10 minutes. Valid examples: 07:40, 12:30, 18:10. Invalid examples: 12:32, 10:15. 2. If no activation time is provided, the current time is used, truncated to the nearest earlier multiple of 10 minutes. For example, if the current time is 14:46, the system will use 14:40.

expire_time timestamp

Expiration time independent of any time zone or calendar. User access right's association expiration time rules: 1. Expiration time must be specified in multiples of 10 minutes. Valid examples: 07:40, 12:30, 18:10. Invalid examples: 12:32, 10:15. 2. When specifying expiration time, it must: - Be at least 10 minutes after activation time. - Always be a multiple of 10 minutes. The system does not round or adjust expiration time for you. For example, if you attempt to set 10:15, the system will reject it.

name string

Output only. Resource name of the user's card key. It must have the format of installations/*/users/*/card-key. For example: installations/surelock-homes-hq/users/john-watson/card-key.

state enum State

Indicates whether this card key has been assigned, not assigned or is active and ready for use. This field cannot be modified using a standard UpdateCardKey operation. To change the value of this field, you must call EncodeCardKey. If the value is NOT_ASSIGNED it also applies to cases where the assignation process has been initiated, but not completed.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The card key is not assigned to a physical card.
PENDING
Value 2. The card key is pending activation.
ACTIVE
Value 3. The card key is active and ready to be used.
outdated boolean

Indicates whether this card key has pending updates or not. This field cannot be modified using a standard UpdateCardKey operation. To change the value of this field, you must call OutdateCardKey.

card_id

The physical card identifier.

uid string

Unique identifier of the physical card. Length dependent of technology. Max length for ISO14443-3 is 10 bytes.

name string

Resource name of the user's app key. It must have the format of installations/*/users/*/app-key. For example: installations/surelock-homes-hq/users/john-watson/app-key.

state enum State

Indicates whether this app key has been assigned or not. This field cannot be modified using a standard UpdateAppKey operation. To change the value of this field, you must call AssignAppKey.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The app key is not assigned.
PENDING
Value 2. The app key is pending activation.
ACTIVE
Value 3. The app key is active and ready to be used.
outdated boolean

Indicates whether this app key has pending updates or not. This field cannot be modified using a standard UpdateAppKey operation. To change the value of this field, you must call OutdateAppKey.

name string

Resource name of the user's wallet key. It must have the format of installations/*/users/*/wallet-key. For example: installations/surelock-homes-hq/users/john-watson/wallet-key.

state enum State

Indicates whether this wallet key has been assigned or not. This field cannot be modified using a standard UpdateWalletKey operation. To change the value of this field, you must call AssignWalletKey.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The wallet key is not assigned.
PENDING
Value 2. The wallet key is pending activation.
ACTIVE
Value 3. The wallet key is active and ready to be used.
outdated boolean

Indicates whether this wallet key has pending updates or not. This field cannot be modified using a standard UpdateWalletKey operation. To change the value of this field, you must call OutdateWalletKey.

name string

Output only. Resource name of the user's passcode. It must have the format of installations/*/users/*/passcode. For example: installations/surelock-homes-hq/users/john-watson/passcode.

state enum State

Indicates whether this passcode has been assigned, not assigned or is active and ready for use. This field cannot be modified using a standard passcode update operation. To change the value of this field, you must call AssignPasscode. If the value is NOT_ASSIGNED it also applies to cases where the assignation process has been initiated, but not completed.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The passcode is not assigned.
ACTIVE
Value 2. The passcode is active and ready to be used.
days array of Day objects

Days when it's valid.

start_time TimeOfDay

Start time of day when schedule starts being valid.

end_time TimeOfDay

End time of day when schedule ends being valid.

day_type enum DayType

Day type

Possible enum values
DAY_TYPE_UNSPECIFIED
Value 0. Unspecified
NORMAL
Value 1. Normal day
HOLIDAY
Value 2. Holidays
SPECIAL_1
Value 3. Special day type 1
SPECIAL_2
Value 4. Special day type 2
day_of_week enum DayOfWeek

In case day_type is NORMAL, the specific day of the week.

Possible enum values
DAY_OF_WEEK_UNSPECIFIED
Value 0. Unspecified
MONDAY
Value 1. Monday
TUESDAY
Value 2. Tuesday
WEDNESDAY
Value 3. Wednesday
THURSDAY
Value 4. Thursday
FRIDAY
Value 5. Friday
SATURDAY
Value 6. Saturday
SUNDAY
Value 7. Sunday
hours integer

Hours of day in 24 hour format. Should be from 0 to 23.

minutes integer

Minutes of hour of day. Must be from 0 to 59.

seconds integer

Seconds of minutes of the time. Must be from 0 to 59.

nanos integer

Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.

Representation of a passcode, belonging to a user

name string

Output only. Resource name of the user's passcode. It must have the format of installations/*/users/*/passcode. For example: installations/surelock-homes-hq/users/john-watson/passcode.

state enum State

Indicates whether this passcode has been assigned, not assigned or is active and ready for use. This field cannot be modified using a standard passcode update operation. To change the value of this field, you must call AssignPasscode. If the value is NOT_ASSIGNED it also applies to cases where the assignation process has been initiated, but not completed.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The passcode is not assigned.
ACTIVE
Value 2. The passcode is active and ready to be used.

Representation of a wallet key, belonging to a user

name string

Resource name of the user's wallet key. It must have the format of installations/*/users/*/wallet-key. For example: installations/surelock-homes-hq/users/john-watson/wallet-key.

state enum State

Indicates whether this wallet key has been assigned or not. This field cannot be modified using a standard UpdateWalletKey operation. To change the value of this field, you must call AssignWalletKey.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The wallet key is not assigned.
PENDING
Value 2. The wallet key is pending activation.
ACTIVE
Value 3. The wallet key is active and ready to be used.
outdated boolean

Indicates whether this wallet key has pending updates or not. This field cannot be modified using a standard UpdateWalletKey operation. To change the value of this field, you must call OutdateWalletKey.

Representation of an app key, belonging to a user

name string

Resource name of the user's app key. It must have the format of installations/*/users/*/app-key. For example: installations/surelock-homes-hq/users/john-watson/app-key.

state enum State

Indicates whether this app key has been assigned or not. This field cannot be modified using a standard UpdateAppKey operation. To change the value of this field, you must call AssignAppKey.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The app key is not assigned.
PENDING
Value 2. The app key is pending activation.
ACTIVE
Value 3. The app key is active and ready to be used.
outdated boolean

Indicates whether this app key has pending updates or not. This field cannot be modified using a standard UpdateAppKey operation. To change the value of this field, you must call OutdateAppKey.

Representation of a card key, belonging to a user

name string

Output only. Resource name of the user's card key. It must have the format of installations/*/users/*/card-key. For example: installations/surelock-homes-hq/users/john-watson/card-key.

state enum State

Indicates whether this card key has been assigned, not assigned or is active and ready for use. This field cannot be modified using a standard UpdateCardKey operation. To change the value of this field, you must call EncodeCardKey. If the value is NOT_ASSIGNED it also applies to cases where the assignation process has been initiated, but not completed.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The card key is not assigned to a physical card.
PENDING
Value 2. The card key is pending activation.
ACTIVE
Value 3. The card key is active and ready to be used.
outdated boolean

Indicates whether this card key has pending updates or not. This field cannot be modified using a standard UpdateCardKey operation. To change the value of this field, you must call OutdateCardKey.

card_id

The physical card identifier.

uid string

Unique identifier of the physical card. Length dependent of technology. Max length for ISO14443-3 is 10 bytes.

The user object

name string

Resource name of the user. It must have the format of installations/*/users/*. For example: installations/surelock-homes-hq/users/john-watson.

given_name string

The personal name, forename or given name ("first name"). It could also contain a middle name. First name is not used because the given name is not placed first in some cultures.

display_name string

The display name of the user, formed by concatenating the first and last name values.

activate_time timestamp

Activation time independent of any time zone or calendar.

expire_time timestamp

Expiration time independent of any time zone or calendar.

photo_uri string

The URI to view the user photo.

card_key CardKey

The card key resource that belongs to the user.

app_key AppKey

The app key resource that belongs to the user.

wallet_key WalletKey

The wallet key resource that belongs to the user.

passcode Passcode

The passcode resource that belongs to the user.

blocked boolean

Indicates whether this user is blocked or not. A blocked user cannot perform any admin actions, that is, if they have a management role this will no longer be valid. If the user has a key then it will no longer unlock access points.

parent string

The name of the parent user of this user. Only users who have had keys shared with them will have this field set.

family_name string

The surname or family name ("last name"). It could also contain more than one surname so that both matrilineal and patrilineal surnames can be included in one place. Last name is not used because the family name is not placed last in some cultures.

email string

Email address.

photo string

The file resource name for the user photo. It must have the format of installations/surelock-homes-hq/files/01DSYSJ1PR36VVC3MRFRV4DC7G.

The user's access right association

name string

Resource name of the user's access right association. It must have the format of installations/*/users/*/access-rights/*. For example: installations/surelock-homes-hq/users/john-watson/access-rights/baskerville.

access_right string

The access right resource name to bind as an association to the parent access point. For example: installations/surelock-homes-hq/access-rights/baskerville.

display_name string

Display name of the associated entity. In this case an access right.

schedules array of Schedule objects

The schedules for the user's access right. If set, this can only be more restrictive than the schedules defined in the associated access right.

effective_schedules array of Schedule objects

The computed effective schedules for the user's access right based on the given parent resource.

activate_time timestamp

Activation time independent of any time zone or calendar. User access right's association activation time rules: 1. Activation time must be specified in multiples of 10 minutes. Valid examples: 07:40, 12:30, 18:10. Invalid examples: 12:32, 10:15. 2. If no activation time is provided, the current time is used, truncated to the nearest earlier multiple of 10 minutes. For example, if the current time is 14:46, the system will use 14:40.

expire_time timestamp

Expiration time independent of any time zone or calendar. User access right's association expiration time rules: 1. Expiration time must be specified in multiples of 10 minutes. Valid examples: 07:40, 12:30, 18:10. Invalid examples: 12:32, 10:15. 2. When specifying expiration time, it must: - Be at least 10 minutes after activation time. - Always be a multiple of 10 minutes. The system does not round or adjust expiration time for you. For example, if you attempt to set 10:15, the system will reject it.

Create a user

Creates a new user.

Input

parent string

Resource name of the parent resource where the user is to be created.

user User

The user resource to be created. Client must not set the User.name field.

user_id string

The user id to use for this user. In case it's empty the server will autogenerate a unique identifier.

Output

name string

Resource name of the user. It must have the format of installations/*/users/*.

given_name string

The personal name, forename or given name ("first name"). It could also contain a middle name. First name is not used because the given name is not placed first in some cultures.

display_name string

The display name of the user, formed by concatenating the first and last name values.

activate_time timestamp

Activation time independent of any time zone or calendar.

expire_time timestamp

Expiration time independent of any time zone or calendar.

photo_uri string

The URI to view the user photo.

card_key CardKey

The card key resource that belongs to the user.

app_key AppKey

The app key resource that belongs to the user.

wallet_key WalletKey

The wallet key resource that belongs to the user.

passcode Passcode

The passcode resource that belongs to the user.

blocked boolean

Indicates whether this user is blocked or not. A blocked user cannot perform any admin actions, that is, if they have a management role this will no longer be valid. If the user has a key then it will no longer unlock access points.

parent string

The name of the parent user of this user. Only users who have had keys shared with them will have this field set.

family_name string

The surname or family name ("last name"). It could also contain more than one surname so that both matrilineal and patrilineal surnames can be included in one place. Last name is not used because the family name is not placed last in some cultures.

email string

Email address.

photo string

The file resource name for the user photo. It must have the format of installations/surelock-homes-hq/files/01DSYSJ1PR36VVC3MRFRV4DC7G.

Get a user

Retrieves an existing user.

Input

name string

The name of the requested user resource.

Output

name string

Resource name of the user. It must have the format of installations/*/users/*.

given_name string

The personal name, forename or given name ("first name"). It could also contain a middle name. First name is not used because the given name is not placed first in some cultures.

display_name string

The display name of the user, formed by concatenating the first and last name values.

activate_time timestamp

Activation time independent of any time zone or calendar.

expire_time timestamp

Expiration time independent of any time zone or calendar.

photo_uri string

The URI to view the user photo.

card_key CardKey

The card key resource that belongs to the user.

app_key AppKey

The app key resource that belongs to the user.

wallet_key WalletKey

The wallet key resource that belongs to the user.

passcode Passcode

The passcode resource that belongs to the user.

blocked boolean

Indicates whether this user is blocked or not. A blocked user cannot perform any admin actions, that is, if they have a management role this will no longer be valid. If the user has a key then it will no longer unlock access points.

parent string

The name of the parent user of this user. Only users who have had keys shared with them will have this field set.

family_name string

The surname or family name ("last name"). It could also contain more than one surname so that both matrilineal and patrilineal surnames can be included in one place. Last name is not used because the family name is not placed last in some cultures.

email string

Email address.

photo string

The file resource name for the user photo. It must have the format of installations/surelock-homes-hq/files/01DSYSJ1PR36VVC3MRFRV4DC7G.

List users

Returns a list of users that have been previously created.

Input

parent string

The parent resource name.

page_size integer

The maximum number of items to return.

page_token string

The next_page_token value returned from a previous List request, if any.

filter string

A filter that chooses which users to return.

order_by string

How the results should be sorted.

Output

users array of User objects

The field name should match the noun users in the method name. There will be a maximum number of items returned based on the page_size field in the request.

next_page_token string

Token to retrieve the next page of results, or empty if there are no more results in the list.

total_size integer

The total number of users in all pages, irrespective of any pagination. This is an estimated number based on the requested filter, and it may change in subsequent pages.

Update a user

Updates an existing user.

Input

user User

The user resource which replaces the resource on the server.

update_mask fieldmask

The update mask applied to the resource.

Output

name string

Resource name of the user. It must have the format of installations/*/users/*.

given_name string

The personal name, forename or given name ("first name"). It could also contain a middle name. First name is not used because the given name is not placed first in some cultures.

display_name string

The display name of the user, formed by concatenating the first and last name values.

activate_time timestamp

Activation time independent of any time zone or calendar.

expire_time timestamp

Expiration time independent of any time zone or calendar.

photo_uri string

The URI to view the user photo.

card_key CardKey

The card key resource that belongs to the user.

app_key AppKey

The app key resource that belongs to the user.

wallet_key WalletKey

The wallet key resource that belongs to the user.

passcode Passcode

The passcode resource that belongs to the user.

blocked boolean

Indicates whether this user is blocked or not. A blocked user cannot perform any admin actions, that is, if they have a management role this will no longer be valid. If the user has a key then it will no longer unlock access points.

parent string

The name of the parent user of this user. Only users who have had keys shared with them will have this field set.

family_name string

The surname or family name ("last name"). It could also contain more than one surname so that both matrilineal and patrilineal surnames can be included in one place. Last name is not used because the family name is not placed last in some cultures.

email string

Email address.

photo string

The file resource name for the user photo. It must have the format of installations/surelock-homes-hq/files/01DSYSJ1PR36VVC3MRFRV4DC7G.

Delete a user

Permanently deletes a user. This cannot be undone.

Input

name string

The resource name of the user to be deleted.

Output

No return value.

Block a user

Temporarily blocks an existing user. While blocked, the user cannot perform any admin actions, that is, they have no management role. Neither can they unlock any access point with any type of key.

Input

name string

The resource name of the user to be blocked.

Output

Unblock a user

Unblocks an already blocked user. Once unblocked, the user can perform the admin actions they could previously, that is, they once again have a management role. They can also once again unlock the access points they previously had access to.

Input

name string

The resource name of the user to be unblocked.

Output

Create a user access right

Creates a user's access right association.

Input

parent string

Resource name of the parent resource where the users's access right association is to be created.

user_access_right UserAccessRight

The user's access right association resource to be created. Client must not set the UserAccessRight.name field.

Output

name string

Resource name of the user's access right association. It must have the format of installations/*/users/*/access-rights/*.

access_right string

The access right resource name to bind as an association to the parent access point.

display_name string

Display name of the associated entity. In this case an access right.

schedules array of Schedule objects

The schedules for the user's access right. If set, this can only be more restrictive than the schedules defined in the associated access right.

effective_schedules array of Schedule objects

The computed effective schedules for the user's access right based on the given parent resource.

activate_time timestamp

Activation time independent of any time zone or calendar. User access right's association activation time rules: 1. Activation time must be specified in multiples of 10 minutes. Valid examples: 07:40, 12:30, 18:10. Invalid examples: 12:32, 10:15. 2. If no activation time is provided, the current time is used, truncated to the nearest earlier multiple of 10 minutes. For example, if the current time is 14:46, the system will use 14:40.

expire_time timestamp

Expiration time independent of any time zone or calendar. User access right's association expiration time rules: 1. Expiration time must be specified in multiples of 10 minutes. Valid examples: 07:40, 12:30, 18:10. Invalid examples: 12:32, 10:15. 2. When specifying expiration time, it must: - Be at least 10 minutes after activation time. - Always be a multiple of 10 minutes. The system does not round or adjust expiration time for you. For example, if you attempt to set 10:15, the system will reject it.

Get a user access right

Gets an existing user's access right association.

Input

name string

The name of the requested user's access right association resource.

Output

name string

Resource name of the user's access right association. It must have the format of installations/*/users/*/access-rights/*.

access_right string

The access right resource name to bind as an association to the parent access point.

display_name string

Display name of the associated entity. In this case an access right.

schedules array of Schedule objects

The schedules for the user's access right. If set, this can only be more restrictive than the schedules defined in the associated access right.

effective_schedules array of Schedule objects

The computed effective schedules for the user's access right based on the given parent resource.

activate_time timestamp

Activation time independent of any time zone or calendar. User access right's association activation time rules: 1. Activation time must be specified in multiples of 10 minutes. Valid examples: 07:40, 12:30, 18:10. Invalid examples: 12:32, 10:15. 2. If no activation time is provided, the current time is used, truncated to the nearest earlier multiple of 10 minutes. For example, if the current time is 14:46, the system will use 14:40.

expire_time timestamp

Expiration time independent of any time zone or calendar. User access right's association expiration time rules: 1. Expiration time must be specified in multiples of 10 minutes. Valid examples: 07:40, 12:30, 18:10. Invalid examples: 12:32, 10:15. 2. When specifying expiration time, it must: - Be at least 10 minutes after activation time. - Always be a multiple of 10 minutes. The system does not round or adjust expiration time for you. For example, if you attempt to set 10:15, the system will reject it.

List user access rights

Lists an existing user's access right associations.

Input

parent string

The parent resource name.

page_size integer

The maximum number of items to return.

page_token string

The next_page_token value returned from a previous List request, if any.

filter string

A filter that chooses which user's access right associations to return.

order_by string

How the results should be sorted.

Output

user_access_rights array of UserAccessRight objects

The field name should match the noun user_access_rights in the method name. There will be a maximum number of items returned based on the page_size field in the request.

next_page_token string

Token to retrieve the next page of results, or empty if there are no more results in the list.

Update a user access right

Updates an existing user's access right associations.

Input

user_access_right UserAccessRight

The user's access right resource which replaces the resource on the server.

update_mask fieldmask

The update mask applied to the resource.

Output

name string

Resource name of the user's access right association. It must have the format of installations/*/users/*/access-rights/*.

access_right string

The access right resource name to bind as an association to the parent access point.

display_name string

Display name of the associated entity. In this case an access right.

schedules array of Schedule objects

The schedules for the user's access right. If set, this can only be more restrictive than the schedules defined in the associated access right.

effective_schedules array of Schedule objects

The computed effective schedules for the user's access right based on the given parent resource.

activate_time timestamp

Activation time independent of any time zone or calendar. User access right's association activation time rules: 1. Activation time must be specified in multiples of 10 minutes. Valid examples: 07:40, 12:30, 18:10. Invalid examples: 12:32, 10:15. 2. If no activation time is provided, the current time is used, truncated to the nearest earlier multiple of 10 minutes. For example, if the current time is 14:46, the system will use 14:40.

expire_time timestamp

Expiration time independent of any time zone or calendar. User access right's association expiration time rules: 1. Expiration time must be specified in multiples of 10 minutes. Valid examples: 07:40, 12:30, 18:10. Invalid examples: 12:32, 10:15. 2. When specifying expiration time, it must: - Be at least 10 minutes after activation time. - Always be a multiple of 10 minutes. The system does not round or adjust expiration time for you. For example, if you attempt to set 10:15, the system will reject it.

Delete a user access right

Deletes a user's access right association. This cannot be undone.

Input

name string

The resource name of the user's access right association to be deleted.

Output

No return value.

Assign a card key

Assigns a card key to an existing user.

Input

name string

The name of the requested user's card key to be assigned.

card_id

The physical card identifier.

uid string

Unique identifier of the physical card. Length dependent of technology. Max length for ISO14443-3 is 10 bytes.

Output

name string

Output only. Resource name of the user's card key. It must have the format of installations/*/users/*/card-key.

state enum State

Indicates whether this card key has been assigned, not assigned or is active and ready for use. This field cannot be modified using a standard UpdateCardKey operation. To change the value of this field, you must call EncodeCardKey. If the value is NOT_ASSIGNED it also applies to cases where the assignation process has been initiated, but not completed.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The card key is not assigned to a physical card.
PENDING
Value 2. The card key is pending activation.
ACTIVE
Value 3. The card key is active and ready to be used.
outdated boolean

Indicates whether this card key has pending updates or not. This field cannot be modified using a standard UpdateCardKey operation. To change the value of this field, you must call OutdateCardKey.

card_id

The physical card identifier.

uid string

Unique identifier of the physical card. Length dependent of technology. Max length for ISO14443-3 is 10 bytes.

Cancel a card key

Cancels an existing user's card key.

Input

name string

The name of the requested user's card key to be canceled.

Output

name string

Output only. Resource name of the user's card key. It must have the format of installations/*/users/*/card-key.

state enum State

Indicates whether this card key has been assigned, not assigned or is active and ready for use. This field cannot be modified using a standard UpdateCardKey operation. To change the value of this field, you must call EncodeCardKey. If the value is NOT_ASSIGNED it also applies to cases where the assignation process has been initiated, but not completed.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The card key is not assigned to a physical card.
PENDING
Value 2. The card key is pending activation.
ACTIVE
Value 3. The card key is active and ready to be used.
outdated boolean

Indicates whether this card key has pending updates or not. This field cannot be modified using a standard UpdateCardKey operation. To change the value of this field, you must call OutdateCardKey.

card_id

The physical card identifier.

uid string

Unique identifier of the physical card. Length dependent of technology. Max length for ISO14443-3 is 10 bytes.

Encode a card key

Encodes an existing user's card key.

Input

name string

The name of the requested user's card key to be encoded.

device

The name of the device to be used as a card encoder. It could be an encoder or an electronic lock and takes the form of a relative resource name: installations/surelock-homes-hq/encoders/dancing-men or installations/surelock-homes-hq/electronic-locks/baker-street-entrance.

encoder string

Device name, when device is an encoder

electronic_lock string

Device name, when device is an electronic lock

controller string

Device name, when device is a controller

Output

name string

The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the name should have the format of operations/some/unique/name.

metadata any

Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.

done boolean

If the value is false, it means the operation is still in progress. If true, the operation is completed, and either error or response is available.

result

The operation result, which can be either an error or a valid response. If done == false, neither error nor response is set. If done == true, exactly one of error or response is set.

error status

The error result of the operation in case of failure or cancellation.

response any

The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is standard Get/Create/Update, the response should be the resource. For other methods, the response should have the type XxxResponse, where Xxx is the original method name. For example: if the original method name is AssignMobileKey(), the inferred response type is AssignMobileKeyResponse.

Assign an app key

Assigns an app key to an existing user.

Input

name string

The name of the requested user's app key to be assigned.

Output

name string

Resource name of the user's app key. It must have the format of installations/*/users/*/app-key.

state enum State

Indicates whether this app key has been assigned or not. This field cannot be modified using a standard UpdateAppKey operation. To change the value of this field, you must call AssignAppKey.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The app key is not assigned.
PENDING
Value 2. The app key is pending activation.
ACTIVE
Value 3. The app key is active and ready to be used.
outdated boolean

Indicates whether this app key has pending updates or not. This field cannot be modified using a standard UpdateAppKey operation. To change the value of this field, you must call OutdateAppKey.

Cancel an app key

Cancels an existing user's app key.

Input

name string

The name of the requested user's app key to be canceled.

Output

name string

Resource name of the user's app key. It must have the format of installations/*/users/*/app-key.

state enum State

Indicates whether this app key has been assigned or not. This field cannot be modified using a standard UpdateAppKey operation. To change the value of this field, you must call AssignAppKey.

Possible enum values
STATE_UNSPECIFIED
Value 0.

Sentinel value used to indicate that the state is unknown, omitted, or is not applicable.

NOT_ASSIGNED
Value 1. The app key is not assigned.
PENDING
Value 2. The app key is pending activation.
ACTIVE
Value 3. The app key is active and ready to be used.
outdated boolean

Indicates whether this app key has pending updates or not. This field cannot be modified using a standard UpdateAppKey operation. To change the value of this field, you must call OutdateAppKey.

Compute data of an app key

Compute an existing user's app key data. Data contains encoded access rights of the user.

Input

name string

The name of the requested user's app key.

Output

data bytes

Computed data of the requested app key.

Assign a wallet key

Assigns a wallet key to an existing user.

Input

name string

The name of the requested user's wallet key to be assigned.

Output

wallet_key WalletKey

The newly-assigned wallet key.

access_uri string

The access URL which contains the data to allow end users to sign in to SALTO Identity seamlessly and which is also used in the add-to-wallet process.

Cancel a wallet key

Cancels an existing user's wallet key.

Input

name string

The name of the requested user's wallet key to be canceled.

Output

wallet_key WalletKey

The canceled wallet key.

Assign a passcode

Assigns a passcode to an existing user.

Input

name string

The name of the requested user's passcode to be assigned.

Output

passcode Passcode

The assigned passcode.

value string

The passcode value.

Cancel a passcode

Cancels an existing user's passcode.

Input

name string

The name of the requested user's passcode to be canceled.

Output

passcode Passcode

The canceled passcode.

Salto Systems, S. L. uses third-party data storage and retrieval devices in order to allow secure browsing and gain a better understanding of how users interact with the website in order to improve our services. You can accept all cookies by clicking the "Accept cookies" button or reject their use by clicking the "Reject cookies" button. For more information, visit our Cookies Policy