https://github.com/robhogan/react-native-securerandom

A crypto-secure random bytes generator for react native
https://github.com/robhogan/react-native-securerandom

cryptography csprng prng randomnumbergenerator react-native secrandomcopybytes securerandom

Last synced: 18 days ago
JSON representation

A crypto-secure random bytes generator for react native

• Host: GitHub
• URL: https://github.com/robhogan/react-native-securerandom
• Owner: robhogan
• License: mit
• Created: 2017-10-11T16:00:02.000Z (about 7 years ago)
• Default Branch: main
• Last Pushed: 2023-07-01T08:16:13.000Z (over 1 year ago)
• Last Synced: 2024-10-12T13:33:44.301Z (about 1 month ago)
• Topics: cryptography, csprng, prng, randomnumbergenerator, react-native, secrandomcopybytes, securerandom
• Language: Java
• Size: 505 KB
• Stars: 62
• Watchers: 3
• Forks: 33
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# react-native-securerandom

[![npm version](https://badge.fury.io/js/react-native-securerandom.svg)](https://badge.fury.io/js/react-native-securerandom)

A library to generate cryptographically-secure random bytes. Uses `SecRandomCopyBytes` on iOS, `SecureRandom` on Android and `System.Security.Cryptography.RandomNumberGenerator` on Windows.

## Usage

The library exports a single function:

### generateSecureRandom(length: number) => Promise\

Takes a length, the number of bytes to generate, and returns a `Promise` that resolves with a `Uint8Array`.

```javascript

import { generateSecureRandom } from 'react-native-securerandom';

generateSecureRandom(12).then(randomBytes => console.log(randomBytes));

```

## Installation

`$ yarn add react-native-securerandom`

### Automatic linking with react-native link

`$ react-native link react-native-securerandom`

### Manual linking

#### iOS

##### With Cocoapods

1. Add `pod 'RNSecureRandom', :path => '../node_modules/react-native-securerandom'` to your `Podfile` (changing your `node_modules` path as appropriate)

2. Run `pod install` from the same directory as your `Podfile`

##### Without Cocoapods

1. In XCode, in the project navigator, right click `Libraries` ➜ `Add Files to [your project's name]`

2. Go to `node_modules` ➜ `react-native-securerandom` and add `RNSecureRandom.xcodeproj`

3. In XCode, in the project navigator, select your project. Add `libRNSecureRandom.a` to your project's `Build Phases` ➜ `Link Binary With Libraries`

#### Android

1. Open up `android/app/src/main/java/[...]/MainActivity.java`

  - Add `import net.rhogan.rnsecurerandom.RNSecureRandomPackage;` to the imports at the top of the file

  - Add `new RNSecureRandomPackage()` to the list returned by the `getPackages()` method

2. Append the following lines to `android/settings.gradle`:

  	```

  	include ':react-native-securerandom'

  	project(':react-native-securerandom').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-securerandom/android')

  	```

3. Insert the following lines inside the dependencies block in `android/app/build.gradle`:

  	```

      compile project(':react-native-securerandom')

  	```

#### Windows

See [react-native-windows](https://github.com/Microsoft/react-native-windows)

1. In Visual Studio add `node_modules/react-native-securerandom/windows/RNSecureRandom.sln` folder to your solution, and reference from your app.

2. Open up your app's `MainPage.cs`

  - Add `using Net.Rhogan.RNSecureRandom.RNSecureRandom;` to the usings at the top of the file

  - Add `new RNSecureRandomPackage()` to the `List` returned by the `Packages` method