k4m4 / wifipass.co

Create Apple Wallet passes for your WiFi credentials.

wifipass.co

Create Apple Wallet passes for your WiFi credentials.

Configuration

Apple Pass Certificates

1. Create a folder named components in the repo's root directory.
2. Follow these instructions to generate your certificate files.
3. Once the files have been generated, place them in the components directory.
4. Rename the certificates to signerCert.pem, signerKey.pem, and wwdr.pem.
5. Create a copy of the .env.example file and name it .env.
6. Add an environment variable for the passphrase that you used when generating the certificates to the PASS_SIGNER_KEY_PASSPHRASE variable.

Firebase

1. Create a new Firebase project in the Firebase console's project overview page.
2. Add the project ID to the FIREBASE_PROJECT_ID environment variable.
3. Navigate to your project's "Service accounts" settings (Project Settings > Service accounts) to generate a private key.
4. Encode the private key using base64 and add it to your FIREBASE_PRIVATE_KEY environment variable.
5. The file that was downloaded when generating the Firebase private key should also include a client_email address. Use that for your FIREBASE_CLIENT_EMAIL environment variable.
6. In the Firebase console, navigate to the Realtime Database page. Copy the database's URL and add it to the FIREBASE_DB_URL environment variable.

Development

To start a development instance run:

~/wifipass.co ❯❯❯ npm install
~/wifipass.co ❯❯❯ npm run dev

You should then be able to access the webapp at http://localhost:3000.

License

MIT © Nikolaos Kamarinakis

wifipass.co's Issues

Typo in readme.md

Is components mistakenly used instead of certificates?

wifipass.co/readme.md

Line 11 in f54f4c6

1. Create a folder named `components` in the repo's root directory.

wifipass.co/readme.md

Line 13 in f54f4c6

1. Once the files have been generated, place them in the `components` directory.

Invalid certificate

It is not possible to install the downloaded passes as the certificate is invalid. Pass checked with Pkpass Validator.

WWDR Certificate
👎 WWDR Certificate is version (G4)

Only the G4 certificate is valid for signing passes with certificates generated after the 27th of January, 2022.

PassKit Certificate
👎 PassKit Certificate in date

Encoding the private key

Hey just after some more info on how to encode the price key to base64. I have encoded it and when I run the server and generate the wifi pass I get an internal server error and get this message in the terminal "Firebase admin initialization error Error: Failed to parse private key: Error: Invalid PEM formatted message."

I am also new to this so I am sure it is something stupid I am doing or have done something wrong.