| /* |
| * Copyright (C) 2019 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package android.net.ipsec.ike; |
| |
| import android.annotation.NonNull; |
| import android.net.ipsec.ike.exceptions.AuthenticationFailedException; |
| import android.os.PersistableBundle; |
| |
| import java.nio.charset.Charset; |
| import java.security.cert.X509Certificate; |
| import java.util.Objects; |
| |
| /** |
| * IkeRfc822AddrIdentification represents an IKE entity identification based on a fully-qualified |
| * RFC 822 email address ID (e.g. ike@android.com). |
| */ |
| public final class IkeRfc822AddrIdentification extends IkeIdentification { |
| private static final Charset UTF8 = Charset.forName("UTF-8"); |
| private static final String RFC822_NAME_KEY = "rfc822Name"; |
| |
| /** The fully-qualified RFC 822 email address. */ |
| @NonNull public final String rfc822Name; |
| |
| /** |
| * Construct an instance of IkeRfc822AddrIdentification from a decoded inbound packet. |
| * |
| * @param rfc822NameBytes fully-qualified RFC 822 email address in byte array. |
| * @hide |
| */ |
| public IkeRfc822AddrIdentification(byte[] rfc822NameBytes) { |
| super(ID_TYPE_RFC822_ADDR); |
| rfc822Name = new String(rfc822NameBytes, UTF8); |
| } |
| |
| /** |
| * Construct an instance of {@link IkeRfc822AddrIdentification} with a fully-qualified RFC 822 |
| * email address. |
| * |
| * @param rfc822Name the fully-qualified RFC 822 email address. |
| */ |
| public IkeRfc822AddrIdentification(@NonNull String rfc822Name) { |
| super(ID_TYPE_RFC822_ADDR); |
| this.rfc822Name = rfc822Name; |
| } |
| |
| /** |
| * Constructs this object by deserializing a PersistableBundle |
| * |
| * @hide |
| */ |
| @NonNull |
| public static IkeRfc822AddrIdentification fromPersistableBundle(@NonNull PersistableBundle in) { |
| Objects.requireNonNull(in, "PersistableBundle is null"); |
| |
| return new IkeRfc822AddrIdentification(in.getString(RFC822_NAME_KEY)); |
| } |
| /** |
| * Serializes this object to a PersistableBundle |
| * |
| * @hide |
| */ |
| @Override |
| @NonNull |
| public PersistableBundle toPersistableBundle() { |
| final PersistableBundle result = super.toPersistableBundle(); |
| result.putString(RFC822_NAME_KEY, rfc822Name); |
| return result; |
| } |
| |
| /** @hide */ |
| @Override |
| public int hashCode() { |
| // idType is also hashed to prevent collisions with other IkeAuthentication subtypes |
| return Objects.hash(idType, rfc822Name); |
| } |
| |
| /** @hide */ |
| @Override |
| public boolean equals(Object o) { |
| if (!(o instanceof IkeRfc822AddrIdentification)) return false; |
| |
| // idType already verified based on class type; no need to check again. |
| return rfc822Name.equals(((IkeRfc822AddrIdentification) o).rfc822Name); |
| } |
| |
| /** @hide */ |
| @Override |
| public String getIdTypeString() { |
| return "RFC822 Address"; |
| } |
| |
| /** @hide */ |
| @Override |
| public void validateEndCertIdOrThrow(X509Certificate endCert) |
| throws AuthenticationFailedException { |
| // The corresponding SAN type is RFC822 Name as per RFC 7296 |
| validateEndCertSanOrThrow(endCert, SAN_TYPE_RFC822_NAME, rfc822Name); |
| } |
| |
| /** |
| * Retrieve the byte-representation of the the RFC 822 email address. |
| * |
| * @return the byte-representation of the RFC 822 email address. |
| * @hide |
| */ |
| @Override |
| public byte[] getEncodedIdData() { |
| return rfc822Name.getBytes(UTF8); |
| } |
| } |