--- title: Getting started with PingOne Credentials description: Learn how to get started with PingOne Credentials. component: pingone page_id: pingone:digital_credentials_using_pingone_credentials:p1_credentials_getting_started canonical_url: https://docs.pingidentity.com/pingone/digital_credentials_using_pingone_credentials/p1_credentials_getting_started.html revdate: January 23, 2025 page_aliases: ["p1_credentials_creating_registering_neo_sdk.adoc"] section_ids: before-you-begin: Before you begin neo_sdk: Developing and registering the wallet app that runs the PingOne wallet native SDK about-this-task: About this task steps: Steps result: Result: result-2: Result: --- # Getting started with PingOne Credentials Learn how to get started with PingOne Credentials. To try out issuance and verification demos for PingOne Credentials, learn more in [PingOne Credentials issuance](https://auth.pingone.com/851e6ca2-7400-49b6-8c24-707ffc2be5ba/davinci/policy/c7eb99d991615349a5a119e69f332d75/authorize?client_id=09df0479f79681a4eaf5879a5c83c633\&response_type=code\&scope=openid\&redirect_uri=https://auth.pingone.com/851e6ca2-7400-49b6-8c24-707ffc2be5ba/davinci/testrp) and [PingOne Credentials verification test](https://auth.pingone.com/851e6ca2-7400-49b6-8c24-707ffc2be5ba/davinci/policy/ad3dcfea4bddcfae3faaf24b05898e1a/authorize?client_id=33fe69dc2d19ad2c238cad3e123d5261\&response_type=code\&scope=openid\&redirect_uri=https://auth.pingone.com/851e6ca2-7400-49b6-8c24-707ffc2be5ba/davinci/testrp). | | | | - | ------------------------------------- | | | These demos don't require any set up. | ## Before you begin **To get started with and access PingOne Credentials, you must have:** * A PingOne account. Learn more in [Starting a PingOne trial](../getting_started_with_pingone/p1_start_a_p1_trial.html). * An environment with a workforce solution that includes PingOne Credentials, PingID, and DaVinci. Learn more in [Building solutions](../getting_started_with_pingone/p1_building_solutions.html). * The PingID mobile app. | | | | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | For native integration, use the SDK. Learn more in [PingOne wallet native SDK](https://developer.pingidentity.com/pingone-api/native-sdks/pingone-neo-native-sdks/pingone-wallet-native-sdks.html) in the PingOne developer documentation. | **To set up PingID as your digital wallet, you must have:** * The PingID mobile app. * A new environment with a workforce solution. Learn more in [Building solutions](../getting_started_with_pingone/p1_building_solutions.html). ![A screen capture of the Create Environment page with Workforce solution selected.](_images/workforce.png) * The PingOne Credentials and DaVinci service in your environment. ![A screen capture of PingOne Credentials service selected.](_images/addcredservice.png) * A credential. Learn more in [Creating a credential](p1_credentials_creating_a_credential.html). For compatibility with the DaVinci flows used for testing, the **Issue**, **Update**, and **Revoke** issuance rules should be set to **Periodic**, and the PingOne Credentials fields must include the following attributes: * **Name - Given Name** * **Name - Family Name** * **Title** * PingID selected as your wallet. Learn more in [Creating a credential](p1_credentials_creating_a_credential.html). ![ A screen capture of the PingID digital wallet selected.](_images/pingid.png) **To test pairing PingID and issuing a credential, you must:** 1. Download the [DaVinci flow - Setup a User Digital Wallet](https://marketplace.pingone.com/item/pingone-neo-starter-flow-setup-a-user-digital-wallet). 2. Import the flow using the instructions on how to import a flow in [How to create a flow](https://docs.pingidentity.com/davinci/flows/davinci_how_to_create_a_flow.html) in the DaVinci documentation. 3. Launch the flow. **To test verifying a credential, you must:** 1. Download the [DaVinci flow - Verifiable Credential Presentation Request](https://marketplace.pingone.com/item/pingone-neo-starter-flow-verifiable-credential-presentation-request). 2. Import the flow using the instructions on how to import a flow in [How to create a flow](https://docs.pingidentity.com/davinci/flows/davinci_how_to_create_a_flow.html) in the DaVinci documentation. 3. Launch the flow. ## Developing and registering the wallet app that runs the PingOne wallet native SDK ### About this task The mobile app guides the user through the process of accepting and sharing credentials. Each user is invited to install and pair their digital wallet by installing a customer-developed app running the SDK. ### Steps 1. Develop an app (for iOS or Android) that runs the SDK, or embed the SDK into an existing app. Learn more in [PingOne wallet native SDK](https://developer.pingidentity.com/pingone-api/native-sdks/pingone-neo-native-sdks/pingone-wallet-native-sdks.html) in the PingOne developer documentation. 2. In the PingOne admin console, create a PingOne application to register your wallet app: 1. Go to **Applications > Applications**. 2. Click the **[icon: plus, set=fa]**icon. #### Result: The **Add Application** panel opens. 3. Enter the appropriate **Application Name** and **Description**. 4. In the **Application Type** section, click **Native**. 5. Click **Save**. #### Result: The details panel opens. 3. To configure the app, on the **Mobile** tab, click the **Pencil** icon: 1. Click **Configure for Android** to configure the app for Android and provide the **Package Name** for Google Play Services or the **Package Name** and **App ID** for Huawei Mobile Services. 2. Click **Configure for iOS** to configure the app for iOS and provide the **Bundle ID**, as registered in the app store. ![Screen capture of the application details panel which the admin can choose to configure.](_images/peo1678922238012.png) 4. **Optional:** To allow push notifications, click **[icon: plus, set=fa]Add Push Notifications**: 1. For Android apps that use Google Play Services, enter a **Server Key**, as provided by FCM. 2. For Android apps that use Huawei Mobile Services, enter a **OAuth 2.0 Client ID** and **Client Secret**. 3. For iOS, enter the **Team ID**, **Select a file** for the**Authentication Token Signing Key**, and enter the **Key ID**, as provided by Apple to your organization. 5. In the **Settings** section: 1. To turn on **Device Integrity Check**, click **On** to prevent the use of compromised devices for pairing or authentication. You can enable device integrity checking separately for Google play Services and iOS. 1. Adjust the **Cache Duration**, the last device integrity check will be cached for a minimum of 1 minute or a maximum 48 hours. 2. If your organization is using the PingOne MFA SDK to allow authentication with a QR code in certain flows, provide the relevant **Universal / App Link** or URI scheme that the application should use for this purpose, depending on which deep-linking mechanism the app developers used. 3. Use the **Passcode Refresh Duration** field to specify the amount of time a passcode should be displayed before it's replaced with a new passcode. 4. To turn on **Configuration for Credentials Digital Wallet link**, click **On**, and enter a **Digital Wallet Link**. The **Digital Wallet Link** value should match the value defined in the customer's application. The **Digital Wallet Link** is used to create pairing links and QR codes that open the customer application. This link can be the same as the **Universal / App Link** or a different one to help distinguish between links for MFA and links for credentials. | | | | - | --------------------------------------------------------------------------------------------------------------------------------- | | | The **Package Name**, **App ID**, **Bundle ID**, and push notification settings can't be modified after you save the application. | 6. Click **Save.** | | | | - | ------------------------------------------------------------------------------------------------ | | | To enable or disable your application in PingOne, click the toggle on the **Applications** page. |