@exoshtw/apple-auth-backend

Logging with Apple

Usage no npm install needed!

<script type="module">
  import exoshtwAppleAuthBackend from 'https://cdn.skypack.dev/@exoshtw/apple-auth-backend';
</script>

README

Apple auth for backend

Library for sign in with Apple to use from server-side.

Usage

import fs from 'fs';
import path from 'path';
import {getAuthToken} from '@exoshtw/node-apple-signin';

export function loginApple(code) {
    const response = await getAuthToken(code, {
        clientId: '....',
        teamId: '....',
        keyId: '...',
        key: fs.readFileSync(path.join(__dirname, 'private_key.p8')),
    });

    console.log(response);

    // {
    //   access_token: '...',
    //   token_type: 'Bearer',
    //   expires_in: 3600,
    //   refresh_token: '...',
    //   id_token: '{encoded_jwt_reponse}',
    //   data: { // <- decoded id_token
    //     iss: 'https://appleid.apple.com',
    //     aud: '...',
    //     exp: 1582046751,
    //     iat: 1582046151,
    //     sub: '...',
    //     at_hash: '...',
    //     email: '...',
    //     email_verified: 'true',
    //     auth_time: 1582046132
    //   }
    // }
}

API

{int} getTimestamp()

Get actual timestamp in int32 format.

{string} generateSecret(options)

Generate the JWT signed token for apple auth

Parameters

Name Type Argument Description
options object Options
options.timestamp int optional Timestamp, autogenerated by default
options.expire int optional Expiration time of token
options.clientId string Apple client id
options.teamId string Apple team id
options.keyId string Private key id

{object} getAuthToken(code, options)

Get the auth token to signing with back code

Parameters

Name Type Argument Description
code string Code returned from client app
options object Options
options.timestamp int optional Timestamp, autogenerated by default
options.expire int optional Expiration time of token
options.clientId string Apple client id
options.teamId string Apple team id
options.keyId string Private key id

Motivation

There are other greats libraries (listed bellow) to use with node, but are focused on generating a sign in url and to work with a callback url.

This library is focused on working from the server-side, for example, to use Apple signin from mobile applications.

Other libraries