---
title: Push Registration node
description: Provides a way to register a device, such as a mobile phone for multi-factor authentication using push notifications.
component: auth-node-ref
version: 7.3
page_id: auth-node-ref::auth-node-push-registration
canonical_url: https://docs.pingidentity.com/auth-node-ref/latest/push-registration.html
llms_txt: https://docs.pingidentity.com/auth-node-ref/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
section_ids:
  outcomes: Outcomes
  properties: Properties
  example: Example
---

# Push Registration node

Provides a way to register a device, such as a mobile phone for multi-factor authentication using push notifications.

For more information, refer to [MFA: Push authentication](https://docs.pingidentity.com/pingam/7.3/authentication-guide/authn-mfa-about-push.html).

The node requires the username of the identity to update.

Implement a [Username Collector node](am-only/auth-node-username-collector.html) (standalone AM) or [Platform Username node](auth-node-platform-username.html) (Ping Identity Platform deployment) before this node in the journey.

You must also configure the *Push Notification Service*.

For information on provisioning the credentials required by the Push Notification Service, refer to [How To Configure Service Credentials (Push Auth, Docker) in Backstage](https://backstage.forgerock.com/knowledge/backstagehelp/article/a92326771) in the *ForgeRock Knowledge Base*.

Find more information about the available properties in [Push Notification Service](https://docs.pingidentity.com/pingam/7.3/reference/global-services-configuration.html#global-pushnotification).

## Outcomes

* `Success`

* `Failure`

* `Time Out`

If the user successfully registers their authenticator, evaluation continues along the `Success` outcome path.

If the node does not receive a response from the user's device within the time specified in the node configuration, evaluation continues along the `Time Out` outcome path.

If AM encounters an issue when attempting to register using a device, evaluation continues along the `Failure` outcome path.

## Properties

| Property                      | Usage                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Issuer                        | Specify an identifier so that the user knows which service their account relates to.The value is displayed by the authenticator application:![The icons represent supported authentication factors supported.](_images/authn-mfa-app-account-list.png)For example, `Example Inc.` or the name of your application.                                                                                                                                                                                                     |
| Account Name                  | Specifies the profile attribute to display as the username in the authenticator application.If not specified, or if the specified profile attribute is empty, their username is used.                                                                                                                                                                                                                                                                                                                                  |
| Registration Response Timeout | Specify the number of seconds to wait for a response from the authenticator.If the specified time is reached, evaluation continues along the `Time Out` outcome path.                                                                                                                                                                                                                                                                                                                                                  |
| Background Color              | Specifies the background color, in hex notation, to display behind the issuer's logo within the ForgeRock Authenticator application.                                                                                                                                                                                                                                                                                                                                                                                   |
| Logo Image URL                | Specifies the location of an image to download and display as the issuer's logo in the ForgeRock Authenticator application.                                                                                                                                                                                                                                                                                                                                                                                            |
| Generate Recovery Codes       | Specify whether push-specific recovery codes should be generated. If enabled, recovery codes are generated and stored in transient state if registration was successful.Use the [Recovery Code Display node](auth-node-recovery-code-display.html) to display the codes to the user for safe keeping.

Generating recovery codes overwrites all existing push-specific recovery codes.

Only the most recent set of recovery codes can be used for authentication if a device has been lost or stolen. |
| QR code message               | The message with instructions to scan the QR code to register the device.Click Add. Enter the message locale in the Key field; for example, `en-gb`. Enter the message to display to the user in the Value field.                                                                                                                                                                                                                                                                                                      |

## Example

Refer to the [Push authentication example journey](auth-node-push-sender.html#push-sender-example) for how to use the Push Registration node in a journey handling push devices.