Ping Identity React Native Device ID

This module provides a native-backed secure device identifier for device fingerprinting, risk signals, and authentication flows.

Table of contents

• Integrating the SDK into your project
• How to Use the SDK
• Platform behavior
• Error handling
• License

Integrating the SDK into your project

Add the package and let autolinking wire the native code:

yarn add @ping-identity/rn-device-id
cd ios && pod install
Copy

Or using npm:

npm install @ping-identity/rn-device-id
cd ios && pod install
Copy

How to Use the SDK

Get the default device ID

import { getDeviceId } from '@ping-identity/rn-device-id';

const deviceId = await getDeviceId();
console.log('Device ID:', deviceId);
Copy

API reference

import { getDeviceId } from '@ping-identity/rn-device-id';
import type {
  DeviceIdError,
  DeviceIdErrorCode,
  DeviceIdLoggerOptions,
} from '@ping-identity/rn-device-id';

function getDeviceId(options?: DeviceIdLoggerOptions): Promise<string>;
Copy

Platform behavior

getDeviceId resolves a stable, secure identifier backed by native platform storage.

• Android: backed by KeyStore-generated material and generally resets after uninstall.
• iOS: backed by Keychain and typically persists across uninstall/reinstall.
• Both platforms: identifier is app/device scoped and returned as a string.

Error handling

All promise rejections use the shared GenericError contract from @ping-identity/rn-types.

import type { DeviceIdError } from '@ping-identity/rn-device-id';

try {
  await getDeviceId();
} catch (error) {
  const deviceIdError = error as DeviceIdError;
  console.log(deviceIdError.type, deviceIdError.error, deviceIdError.message);
}
Copy

License

MIT