| 1 | // Copyright (c) 2018, Yubico AB | |
| 2 | // All rights reserved. | |
| 3 | // | |
| 4 | // Redistribution and use in source and binary forms, with or without | |
| 5 | // modification, are permitted provided that the following conditions are met: | |
| 6 | // | |
| 7 | // 1. Redistributions of source code must retain the above copyright notice, this | |
| 8 | // list of conditions and the following disclaimer. | |
| 9 | // | |
| 10 | // 2. Redistributions in binary form must reproduce the above copyright notice, | |
| 11 | // this list of conditions and the following disclaimer in the documentation | |
| 12 | // and/or other materials provided with the distribution. | |
| 13 | // | |
| 14 | // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 15 | // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 16 | // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | |
| 17 | // DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE | |
| 18 | // FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
| 19 | // DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR | |
| 20 | // SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER | |
| 21 | // CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, | |
| 22 | // OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | |
| 23 | // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 24 | ||
| 25 | package com.yubico.webauthn.data; | |
| 26 | ||
| 27 | import com.fasterxml.jackson.annotation.JsonIgnore; | |
| 28 | ||
| 29 | /** | |
| 30 | * Authenticators respond to Relying Party requests by returning an object derived from the {@link | |
| 31 | * AuthenticatorResponse} interface. | |
| 32 | * | |
| 33 | * @see <a href="https://www.w3.org/TR/2021/REC-webauthn-2-20210408/#authenticatorresponse">§5.2. | |
| 34 | * Authenticator Responses (interface AuthenticatorResponse) </a> | |
| 35 | */ | |
| 36 | public interface AuthenticatorResponse { | |
| 37 | ||
| 38 | /** | |
| 39 | * The authenticator data returned by the authenticator. See <a | |
| 40 | * href="https://www.w3.org/TR/2021/REC-webauthn-2-20210408/#sctn-authenticator-data">§6.1 | |
| 41 | * Authenticator Data</a>. | |
| 42 | */ | |
| 43 | ByteArray getAuthenticatorData(); | |
| 44 | ||
| 45 | /** {@link #getAuthenticatorData()} parsed as a domain object. */ | |
| 46 | @JsonIgnore | |
| 47 | default AuthenticatorData getParsedAuthenticatorData() { | |
| 48 |
1
1. getParsedAuthenticatorData : replaced return value with null for com/yubico/webauthn/data/AuthenticatorResponse::getParsedAuthenticatorData → NO_COVERAGE |
return new AuthenticatorData(getAuthenticatorData()); |
| 49 | } | |
| 50 | ||
| 51 | /** | |
| 52 | * The JSON-serialized client data (see <a | |
| 53 | * href="https://www.w3.org/TR/2021/REC-webauthn-2-20210408/#dictionary-client-data">§5.10.1 | |
| 54 | * Client Data Used in WebAuthn Signatures</a> (dictionary {@link CollectedClientData})) passed to | |
| 55 | * the authenticator by the client in the call to either <code>navigator.credentials.create() | |
| 56 | * </code> or <code>navigator.credentials.get()</code>. The exact JSON serialization MUST be | |
| 57 | * preserved, as the hash of the serialized client data has been computed over it. | |
| 58 | */ | |
| 59 | ByteArray getClientDataJSON(); | |
| 60 | ||
| 61 | /** {@link #getClientDataJSON()} parsed as a domain object. */ | |
| 62 | @JsonIgnore | |
| 63 | CollectedClientData getClientData(); | |
| 64 | } | |
Mutations | ||
| 48 |
1.1 |