Add the PPAPI X509 Certificate interface and implementation.

ppapi/api/private/ppb_flash_x509_certificate.idl

+/* Copyright (c) 2012 The Chromium Authors. All rights reserved.
+ * Use of this source code is governed by a BSD-style license that can be
+ * found in the LICENSE file.
+ */
+
+/**
+ * This file defines the <code>PPB_Flash_X509Certificate</code> interface for
+ * an X509 certificate.
+ */
+
+label Chrome {
+  M19 = 0.1
+};
+
+/**
+ * This enumeration corresponds to fields of an X509 certificate. Refer to
+ * <a href="http://www.ietf.org/rfc/rfc5280.txt>RFC 5280</a> for further
+ * documentation about particular fields.
+ */
+[assert_size(4)]
+enum PP_Flash_X509Certificate_Field {
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_ISSUER_COMMON_NAME = 0,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_ISSUER_LOCALITY_NAME = 1,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_ISSUER_STATE_OR_PROVINCE_NAME = 2,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_ISSUER_COUNTRY_NAME = 3,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_ISSUER_ORGANIZATION_NAME = 4,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_ISSUER_ORGANIZATION_UNIT_NAME_ = 5,

[yzshen1, 2012/03/20 06:48:01]

Please remove the trailing underscore. (There are several enum values that you
need to do the same thing.)

[raymes, 2012/03/21 20:28:08]

Done.

+
+  /**
+   * This corresponds to a byte array (<code>PP_VARTYPE_ARRAY_BUFFER</code>).
+   */
+  PP_FLASH_X509CERTIFICATE_ISSUER_UNIQUE_ID_ = 6,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_PRINCIPAL_COMMON_NAME = 7,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_PRINCIPAL_LOCALITY_NAME = 8,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_PRINCIPAL_STATE_OR_PROVINCE_NAME = 9,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_PRINCIPAL_COUNTRY_NAME = 10,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_PRINCIPAL_ORGANIZATION_NAME = 11,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_PRINCIPAL_ORGANIZATION_UNIT_NAME_ = 12,
+
+  /**
+   * This corresponds to a byte array (<code>PP_VARTYPE_ARRAY_BUFFER</code>).
+   */
+  PP_FLASH_X509CERTIFICATE_PRINCIPAL_UNIQUE_ID_ = 13,
+
+  /**
+   * This corresponds to an integer (<code>PP_VARTYPE_INT32</code>) which
+   * which can be cast to a <code>PPB_Flash_X509_Certificate_Version</code>.
+   */
+  PP_FLASH_X509CERTIFICATE_VERSION = 14,
+
+  /**
+   * This corresponds to a byte array (<code>PP_VARTYPE_ARRAY_BUFFER</code>).
+   * The serial number has the leading 0 removed.
+   */
+  PP_FLASH_X509CERTIFICATE_SERIAL_NUMBER = 15,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_ALGORITHM_OID = 16,
+
+  /**
+   * This corresponds to a byte array (<code>PP_VARTYPE_ARRAY_BUFFER</code>)
+   * which is DER-encoded.
+   */
+  PP_FLASH_X509CERTIFICATE_ALGORITHM_PARAMATERS_RAW = 17,
+
+  /** This corresponds to a date (<code>PP_TIME</code>). */
+  PP_FLASH_X509CERTIFICATE_VALIDITY_NOT_BEFORE = 18,
+
+  /** This corresponds to a date (<code>PP_TIME</code>). */
+  PP_FLASH_X509CERTIFICATE_VALIDITY_NOT_AFTER = 19,
+
+  /** This corresponds to a string (<code>PP_VARTYPE_STRING</code>). */
+  PP_FLASH_X509CERTIFICATE_SUBJECT_PUBLIC_KEY_ALGORITHM_OID = 19,
+
+  /**
+   * This corresponds to a byte array (<code>PP_VARTYPE_ARRAY_BUFFER</code>).
+   */
+  PP_FLASH_X509CERTIFICATE_SUBJECT_PUBLIC_KEY = 20,
+
+  /**
+   * This corresponds to a byte array (<code>PP_VARTYPE_ARRAY_BUFFER</code>).
+   * This is the DER-encoded representation of the certificate.
+   */
+  PP_FLASH_X509CERTIFICATE_RAW = 21
+};
+
+/**
+ * This enumeration defines the different possible values for X5O9 certificate
+ * versions as returned by:
+ * <code>GetField(resource, PP_FLASH_X509CERTIFICATE_VERSION)</code>.
+ */
+[assert_size(4)]
+enum PPB_Flash_X509_Certificate_Version {

[yzshen1, 2012/03/20 06:48:01]

Please remove the underscore between X509 and Certificate, in order to be
consistent. (Same for enum values.)

[raymes, 2012/03/21 20:28:08]

Done.

+  PP_FLASH_X509_CERTIFICATE_V1 = 0,
+  PP_FLASH_X509_CERTIFICATE_V2 = 1,
+  PP_FLASH_X509_CERTIFICATE_V3 = 2
+};
+
+/**
+ * The <code>PPB_Flash_X509Certificate</code> interface provides access to
+ * the fields of an X509 certificate.
+ */
+interface PPB_Flash_X509Certificate {
+  /**
+   * Allocates a <code>PPB_Flash_X509Certificate</code> resource.
+   * <code>Init()</code> must be called before using the certificate.
+   */
+  PP_Resource Create([in] PP_Instance instance);
+
+  /**
+   * Returns <code>PP_TRUE</code> if a given resource is a
+   * <code>PPB_Flash_X509Certificate</code>.
+   */
+  PP_Bool IsFlashX509Certificate([in] PP_Resource resource);
+
+  /**
+   * Initialize a <code>PPB_Flash_X509Certificate</code> from the DER-encoded

[yzshen1, 2012/03/20 06:48:01]

nit: Initialize -> Initializes.

+   * representation. |bytes| should represent only a single certificate.
+   * <code>PP_FALSE</code> is returned if |bytes| is not a valid DER-encoding of
+   * a certificate. Note: Flash requires this to be synchronous.
+   */
+  PP_Bool Init([in] PP_Resource resource,

[yzshen1, 2012/03/20 06:48:01]

- Is it necessary to be synchronous? If anything can be done at the flash side
to make this async, we should probably do that.
- What is the reasons that we don't want to merge this with Create? (If we make
it async, then initialization makes sense to be a separate step.)
- If we would like to keep this method, it is better to be named as
Initialize().

[raymes, 2012/03/21 20:28:08]

The flash side is a sync-call from AS. I discussed with Trung and he recommended
going with the sync-call since there would be no easy way to do it with a
callback.
Since I realized this should probably be async, I decided to make it an Init,
even though it is synchronous for now. I thought there would be fewer changes to
the interface and more consistent if we introduced an async version later.
Done.

+               [in] str_t bytes,
+               [in] uint32_t length);
+
+  /**
+   * Get a field of the X509Certificate as a <code>PP_Var</code>. A null
+   * <code>PP_Var</code> is returned if the field is unavailable.
+   */
+  PP_Var GetField([in] PP_Resource resource,
+                  [in] PP_Flash_X509Certificate_Field field);
+};