apple-auth's Introduction

Apple-Auth

Install via Nuget.org

Install-Package Golap.AppleAuth

Usage

Apple client

var teamId = "0ABCD123XQ"; // Can be retrieve on the Membership information section (https://developer.apple.com/account/#/membership)
var clientId = "com.my.app"; // Identifier of the Apple Service used to Sign in with Apple (https://developer.apple.com/account/resources/identifiers/list/serviceId)
var redirectUri = "https://my.com/apple/redirect"; // your callback
var keyId = "X987654321"; // Id of the key (https://developer.apple.com/account/resources/authkeys)
var keyPath = "Files/key.p8"; // Can be download during the key creation (https://developer.apple.com/account/resources/authkeys)

var authSetting = new AppleAuthSetting(teamId, clientId, redirectUri);
var keySetting = new AppleKeySetting(keyId, File.ReadAllText(keyPath));

var client = new AppleAuthClient(authSetting, keySetting);

Methods

LoginUri() - Generates the Login URI that your users will use to login to
AccessTokenAsync(grantCode) - Get the access token from the server based on the grant code returned by Apple
RefreshTokenAsync(refreshToken) - Refresh an accessToken from a refresh token

Apple Verifier

var verifier = new AppleVerifier();

Methods

ValidateAsync(jwtToken, clientId) - Check an Apple token validity

Common errors

"Invalid_grant" error when you go to a generated login uri
- Check that the redirect url is added to your Apple service in your developer account
- Check the validity of your settings
AppleAuthException when you try to get an access token
- The grant code is invalid
- An Apple grant code sent on your redirect URI can only used once for security reasons