training/articles/security-config.jd

page.title=Configuracin de seguridad de la red
page.keywords=androidn,security,network
page.image=images/cards/card-nyc_2x.jpg

@jd:body

<div id="tb-wrapper">
<div id="tb">

<h2>En este documento</h2>
<ol>
  <li><a href="#manifest">Agregar un archivo de configuracin de seguridad</a></li>
  <li><a href="#CustomTrust">Personalizar las CA de confianza</a>
      <ol>
      <li><a href="#ConfigCustom">Configurar una CA de confianza personalizada</a></li>
      <li><a href="#LimitingCas">Limitar el conjunto de CA de confianza</a></li>
      <li><a href="#TrustingAdditionalCas">Otorgar confianza a CA adicionales</a></li>
      </ol>
  </li>
  <li><a href="#TrustingDebugCa">CA de solo depuracin</a></li>
  <li><a href="#UsesCleartextTraffic">Desactivar el trfico de Cleartext</a></li>
  <li><a href="#CertificatePinning">Fijar certificados</a></li>
  <li><a href="#ConfigInheritance">Comportamiento de herencia de configuracin</a></li>
  <li><a href="#FileFormat">Formato del archivo de configuracin</a></li>
</ol>
</div>
</div>


<p>
  Android N incluye una funcin de configuracin de seguridad de la red
 que les permite a las aplicaciones personalizar los ajustes de seguridad de la red mediante un archivo
 de configuracin declarativo seguro sin que haya que modificar el cdigo de la aplicacin. Estos ajustes se pueden
 configurar para dominios especficos y para una aplicacin especfica. Las capacidades
 clave de esta funcin son las siguientes:
</p>

<ul>
  <li>
    <b>Anclajes de confianza personalizados:</b> personalizar qu autoridades de certificado (CA)
 son de confianza para las conexiones de seguridad de una aplicacin. Por ejemplo,
 confiar en certificados autofirmados particulares
 o restringir el conjunto de CA pblicas en las que confa la aplicacin.
  </li>

  <li>
    <b>Anulaciones de solo depuracin:</b> depurar de forma segura conexiones
 de una aplicacin sin riesgos adicionales para la base instalada.
  </li>

  <li>
    <b>Desactivacin del trfico de Cleartext:</b> proteger a las aplicaciones del
 uso accidental de trfico de Cleartext.
  </li>

  <li>
    <b>Fijacin de certificados:</b> restringir la conexin segura de una aplicacin
 a certificados en particular.
  </li>
</ul>


<h2 id="manifest">Agregar un archivo de configuracin de seguridad</h2>

<p>
  La funcin de configuracin de seguridad de la red usa un archivo XML donde
 se especifican los ajustes para la aplicacin. Debes incluir una entrada en el manifiesto de tu
 aplicacin que apunte a este archivo. El siguiente fragmento de cdigo de un manifiesto
 demuestra cmo crear esta entrada:
</p>

<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;manifest ... &gt;
  &lt;application ... &gt;
    &lt;meta-data android:name="android.security.net.config"
               android:resource="@xml/network_security_config" /&gt;
    ...
  &lt;/application&gt;
&lt;/manifest&gt;
</pre>

<h2 id="CustomTrust">Personalizar las CA de confianza</h2>

<p>
  Una aplicacin podra querer otorgar confianza a un conjunto personalizado de CA en lugar de hacerlo segn los ajustes
 predeterminados de la plataforma. Las razones ms comunes son las siguientes:
</p>

<ul>
  <li>Conectarse a un host con una autoridad de certificado personalizada (autofirmado,
 emitido por una CA corporativa interna, etc.).
  </li>

  <li>Limitar el conjunto de CA a CA de confianza establecidas por el usuario y no a cada
 CA preinstalada.
  </li>

  <li>Otorgar confianza a CA adicionales que no estn incluidas en el sistema
  </li>
</ul>

<p>
  De forma predeterminada, las conexiones seguras (p. ej.: TLS, HTTP) de todas las aplicaciones dependen de
  las CA preinstaladas del sistema; las aplicaciones que tienen como objetivo a la API nivel 23
 (Android M) e inferiores tambin dependen de la tienda de CA agregada por el usuario de forma predeterminada. Una
 aplicacin puede personalizar sus propias conexiones usando {@code base-config} (para
 la personalizacin de toda la aplicacin) o {@code domain-config} (para la personalizacin
 por dominio).
</p>


<h3 id="ConfigCustom">Configurar una CA de confianza personalizada</h3>

<p>
  Supongamos que deseas conectarte a tu host, el cual usa un certificado SSL
 autofirmado, o a un host cuyo certificado SSL est emitido por una CA no pblica
 en la cual confas, como la CA interna de tu empresa.
</p>

<p>
  <code>res/xml/network_security_config.xml</code>:
<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;network-security-config&gt;
    &lt;domain-config&gt;
        &lt;domain includeSubdomains="true"&gt;example.com&lt;/domain&gt;
        &lt;trust-anchors&gt;
            &lt;certificates src="@raw/my_ca"/&gt;
        &lt;/trust-anchors&gt;
    &lt;/domain-config&gt;
&lt;/network-security-config&gt;
</pre>
</p>

<p>
  Agrega el certificado de CA autofirmado o no pblico, en formato PEM o DER, a
 {@code res/raw/my_ca}.
</p>


<h3 id="LimitingCas">Limitar el conjunto de CA de confianza</h3>

<p>
  Una aplicacin que no desee confiar en todas las CA en que confa el sistema puede,
 en su lugar, especificar su propio conjunto reducido de CA en las que confa. Esto protege a la aplicacin
 de certificados fraudulentos emitidos por cualquiera de las dems CA.
</p>

<p>
  La configuracin para limitar el conjunto de CA de confianza es similar a <a href="#TrustingACustomCa">confiar en una CA personalizada</a> para un dominio especfico, con la diferencia
 de que se brindan mltiples CA en el recurso.
</p>

<p>
<code>res/xml/network_security_config.xml</code>:
<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;network-security-config&gt;
    &lt;domain-config&gt;
        &lt;domain includeSubdomains="true"&gt;secure.example.com&lt;/domain&gt;
        &lt;domain includeSubdomains="true"&gt;cdn.example.com&lt;/domain&gt;
        &lt;trust-anchors&gt;
            &lt;certificates src="@raw/trusted_roots"/&gt;
        &lt;/trust-anchors&gt;
    &lt;/domain-config&gt;
&lt;/network-security-config&gt;
</pre>
</p>

<p>
  Agrega las CA de confianza, en formato PEM o DER, a {@code res/raw/trusted_roots}.
  Ten en cuenta que, si usas el formato PEM, el archivo debe incluir <em>solo</em> datos PEM
 y ningn texto adicional. Tambin puedes brindar elementos
<a href="#certificates"><code>&lt;certificates&gt;</code></a>
 mltiples en lugar de solo uno.
</p>


<h3 id="TrustingAdditionalCas">
  Otorgar confianza a CA adicionales
</h3>

<p>
  Una aplicacin podra querer otorgar confianza a CA adicionales en las cuales el sistema no confa,
 ya sea porque el sistema an no incluye la CA o porque la CA no
 cumple con los requisitos de inclusin del sistema Android. La
 aplicacin puede hacerlo especificando mltiples fuentes de certificado para una
 configuracin.
</p>
<p>
<code>res/xml/network_security_config.xml</code>:
<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;network-security-config&gt;
    &lt;base-config&gt;
        &lt;trust-anchors&gt;
            &lt;certificates src="@raw/extracas"/&gt;
            &lt;certificates src="system"/&gt;
        &lt;/trust-anchors&gt;
    &lt;/base-config&gt;
&lt;/network-security-config&gt;
</pre>
</p>


<h2 id="TrustingDebugCa">Configurar las CA para depuracin</h2>

<p>
  Cuando depuras una aplicacin que se conecta mediante HTTPS, podras querer
 conectarte a un servidor de desarrollo local que no tiene el certificado
 SSL de tu servidor de produccin. Para poder hacerlo sin
 tener que modificar el cdigo de tu aplicacin, puedes especificar CA de solo depuracin que
 solo <i>son</i> de confianza cuando <a href="{@docRoot}guide/topics/manifest/application-element.html#debug">
android:debuggable</a>
 es {@code true} usando {@code debug-overrides}. Generalmente, las herramientas de IDE
 y de compilacin configuran esta marca automticamente para las compilaciones que no son de lanzamiento.
</p>

<p>
  Esto es ms seguro que el cdigo condicional habitual ya que, como precaucin
 de seguridad, las tiendas de aplicaciones no aceptan aplicaciones que estn marcadas
 como depurables.
</p>

<p>
<code>res/xml/network_security_config.xml</code>:
<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;network-security-config&gt;
    &lt;debug-overrides&gt;
        &lt;trust-anchors&gt;
            &lt;certificates src="@raw/debug_cas"/&gt;
        &lt;/trust-anchors&gt;
    &lt;/debug-overrides&gt;
&lt;/network-security-config&gt;
</pre>
</p>


<h2 id="UsesCleartextTraffic">Desactivar el trfico de Cleartext</h2>

<p>
  Las aplicaciones que deseen conectarse a destinos usando solo conexiones
 seguras pueden desactivar Cleartext (usando el protocolo
 HTTP no encriptado en lugar del protocolo HTTPS) para esos destinos. Esta opcin ayuda a prevenir
 las regresiones accidentales en aplicaciones debido a cambios en direcciones URL generados por fuentes
 externas como servidores backend.
  Consulta {@link android.security.NetworkSecurityPolicy#isCleartextTrafficPermitted
 NetworkSecurityPolicy.isCleartextTrafficPermitted()} para obtener ms informacin.
</p>

<p>
  Por ejemplo, una aplicacin puede querer garantizar que todas las conexiones a {@code
secure.example.com} se hagan siempre mediante HTTPS para proteger el trfico sensible
 de redes hostiles.
</p>

<p>
<code>res/xml/network_security_config.xml</code>:
<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;network-security-config&gt;
    &lt;domain-config usesCleartextTraffic="false"&gt;
        &lt;domain includeSubdomains="true"&gt;secure.example.com&lt;/domain&gt;
    &lt;/domain-config&gt;
&lt;/network-security-config&gt;
</pre>
</p>


<h2 id="CertificatePinning">Fijar certificados</h2>

<p>
  Generalmente, una aplicacin otorga confianza a todas las CA preinstaladas. Si alguna de estas CA emitiera
 un certificado fraudulento, la aplicacin estara en riesgo de sufrir un ataque
 MiTM. Algunas aplicaciones eligen limitar el conjunto de certificados que aceptan
 ya sea limitando el conjunto de CA al que otorgan confianza o fijando certificados.
</p>

<p>
  La fijacin de certificados se hace brindando un conjunto de certificados por hash de la
 clave pblica (SubjectPublicKeyInfo del certificado X.509). De este modo,
 una cadena de certificados solo es vlida si contiene al menos una de
 las claves pblicas fijadas.
</p>

<p>
  Ten en cuenta que, cuando uses la fijacin de certificados, siempre debes incluir una clave
 de respaldo para que, si te ves obligado a cambiar a claves nuevas o a cambiar de CA (cuando
 fijas un certificado de CA o un intermediario de esa CA), la conectividad
 de la aplicacin no se vea afectada. Si no, debers actualizar
 la aplicacin para recuperar la conectividad.
</p>

<p>
  Adems, se puede configurar un tiempo de expiracin para las fijaciones,
 luego del cual las fijaciones dejan de realizarse. Esto ayuda a evitar los problemas de conectividad
 en aplicaciones que no se han actualizado. Sin embargo, configurar un tiempo de expiracin
 para las fijaciones puede habilitar la omisin de fijaciones.
</p>

<p>
<code>res/xml/network_security_config.xml</code>:
<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;network-security-config&gt;
    &lt;domain-config&gt;
        &lt;domain includeSubdomains="true"&gt;example.com&lt;/domain&gt;
        &lt;pin-set expiration="2018-01-01"&gt;
            &lt;pin digest="SHA-256"&gt;7HIpactkIAq2Y49orFOOQKurWxmmSFZhBCoQYcRhJ3Y=&lt;/pin&gt;
            &lt;!-- backup pin --&gt
            &lt;pin digest="SHA-256"&gt;fwza0LRMXouZHRC8Ei+4PyuldPDcf3UKgO/04cDM1oE=&lt;/pin&gt;
        &lt;/pin-set&gt;
    &lt;/domain-config&gt;
&lt;/network-security-config&gt;
</pre>
</p>


<h2 id="ConfigInheritance">Comportamiento de herencia de configuracin</h2>

<p>
  Los valores que no se establecen en una configuracin especfica se heredan. Este comportamiento permite configuraciones
 ms complejas y un archivo de configuracin de fcil lectura.
</p>

<p>
  Si no se establece un valor en una entrada especfica, se usa el valor de
 la siguiente entrada ms general. Los valores no establecidos en una {@code domain-config} se
 toman de la {@code domain-config} primaria, si estn anidados, o de la {@code
base-config}, si no estn anidados. Los valores no establecidos en la {@code base-config} usan
 los valores predeterminados de la plataforma.
</p>

<p>
  Por ejemplo, cuando todas las conexiones a subdominios de {@code
example.com} deben usar un conjunto personalizado de CA. Adems, el trfico de Cleartext a
 estos dominios se permite <em>excepto</em> con las conexiones a {@code
 secure.example.com}. Anidando la configuracin para {@code
secure.example.com} dentro de la configuracin para {@code example.com},
 {@code trust-anchors} no necesita duplicacin.
</p>

<p>
<code>res/xml/network_security_config.xml</code>:
<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;network-security-config&gt;
    &lt;domain-config&gt;
        &lt;domain includeSubdomains="true"&gt;example.com&lt;/domain&gt;
        &lt;trust-anchors&gt;
            &lt;certificates src="@raw/my_ca"/&gt;
        &lt;/trust-anchors&gt;
        &lt;domain-config cleartextTrafficPermitted="false"&gt;
            &lt;domain includeSubdomains="true"&gt;secure.example.com&lt;/domain&gt;
        &lt;/domain-config&gt;
    &lt;/domain-config&gt;
&lt;/network-security-config&gt;
</pre>
</p>


<h2 id="FileFormat">Formato del archivo de configuracin</h2>

<p>
  La funcin de configuracin de seguridad de la red usa un formato de archivo XML.
  La estructura general del archivo se muestra en el siguiente ejemplo de cdigo:
</p>

<pre>
&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;network-security-config&gt;
    &lt;base-config&gt;
        &lt;trust-anchors&gt;
            &lt;certificates src="..."/&gt;
            ...
        &lt;/trust-anchors&gt;
    &lt;/base-config&gt;

    &lt;domain-config&gt;
        &lt;domain&gt;android.com&lt;/domain&gt;
        ...
        &lt;trust-anchors&gt;
            &lt;certificates src="..."/&gt;
            ...
        &lt;/trust-anchors&gt;
        &lt;pin-set&gt;
            &lt;pin digest="..."&gt;...&lt;/pin&gt;
            ...
        &lt;/pin-set&gt;
    &lt;/domain-config&gt;
    ...
    &lt;debug-overrides&gt;
        &lt;trust-anchors&gt;
            &lt;certificates src="..."/&gt;
            ...
        &lt;/trust-anchors&gt;
    &lt;/debug-overrides&gt;
&lt;/network-security-config&gt;
</pre>

<p>
  Las siguientes secciones describen la sintaxis y otros detalles del formato
 de archivo.
</p>

<h3 id="network-security-config">
  &lt;network-security-config&gt;
</h3>

<dl class="xml">
  <dt>
    PUEDE CONTENER:
  </dt>

  <dd>
    0 o 1 de <code><a href="#base-config">&lt;base-config&gt;</a></code><br>
    Cualquier cantidad de <code><a href=
    "#domain-config">&lt;domain-config&gt;</a></code><br>
    0 o 1 de <code><a href="#debug-overrides">&lt;debug-overrides&gt;</a></code>
  </dd>
</dl>

<h3 id="base-config">
  &lt;base-config&gt;
</h3>

<dl class="xml">
  <dt>
    SINTAXIS:
  </dt>
</dl>

<pre class="stx">
&lt;base-config <a href=
"#usesCleartextTraffic">usesCleartextTraffic</a>=["true" | "false"]&gt;
    ...
&lt;/base-config&gt;
</pre>
<dl class="xml">
  <dt>
    PUEDE CONTENER:
  </dt>

  <dd>
    <code><a href="#trust-anchors">&lt;trust-anchors&gt;</a></code>
  </dd>

  <dt>
    DESCRIPCIN:
  </dt>

  <dd>
    La configuracin predeterminada usada por todas las conexiones cuyo destino no
 est cubierto por una <a href="#domain-config"><code>domain-config</code></a>.

<p>
  Los valores que no estn configurados usan los valores predeterminados de la plataforma. La configuracin predeterminada
 para aplicaciones con API nivel 24 o superior es:
</p>

<pre>
&lt;base-config usesCleartextTraffic="true"&gt;
    &lt;trust-anchors&gt;
        &lt;certificates src="system" /&gt;
    &lt;/trust-anchors&gt;
&lt;/base-config&gt;
</pre>
La configuracin predeterminada para aplicaciones con API nivel 23 o inferior es:
<pre>
&lt;base-config usesCleartextTraffic="true"&gt;
    &lt;trust-anchors&gt;
        &lt;certificates src="system" /&gt;
        &lt;certificates src="user" /&gt;
    &lt;/trust-anchors&gt;
&lt;/base-config&gt;
</pre>

  </dd>
</dl>

<h3 id="domain-config">&lt;domain-config&gt;</h3>
<dl class="xml">
<dt>SINTAXIS:</dt>
<dd>
<pre class="stx">&lt;domain-config <a href="#usesCleartextTraffic">usesCleartextTraffic</a>=["true" | "false"]&gt;
    ...
&lt;/domain-config&gt;</pre>
</dd>

<dt>PUEDE CONTENER:</dt>

<dd>
1 o ms <code><a href="#domain">&lt;domain&gt;</a></code>
<br/>0 o 1 <code><a href="#trust-anchors">&lt;trust-anchors&gt;</a></code>
<br/>0 o 1 <code><a href="#pin-set">&lt;pin-set&gt;</code></a>
<br/>Cualquier cantidad de <code>&lt;domain-config&gt;</code> anidadas</dd>

<dt>DESCRIPCIN</dt>
<dd>Configuracin usada para conexiones con destinos especficos, como los definidos por elementos de {@code domain}.

<p>Ten en cuenta que, si mltiples elementos de {@code domain-config} cubren un destino, la configuracin con la regla de coincidencia de dominio ms especfica (ms larga)
 es la que se usa.</p></dd>
</dl>


<h3 id="domain">&lt;domain&gt;</h3>

<dl class="xml">
  <dt>
    SINTAXIS:
  </dt>

  <dd>
    <pre class="stx">
&lt;domain includeSubdomains=["true" | "false"]&gt;example.com&lt;/domain&gt;
</pre>
  </dd>

  <dt>
    ATRIBUTOS:
  </dt>

  <dd>
    <dl class="attr">
      <dt>
        {@code includeSubdomains}
      </dt>

      <dd>
        Si es {@code "true"}, esta regla de dominio coincide con el dominio
 y con todos los subdominios, incluidos los subdominios de subdominios. Si no, la regla
 solo se aplica a coincidencias exactas.
      </dd>
    </dl>
  </dd>

  <dt>
    DESCRIPCIN:
  </dt>
</dl>

<h3 id="debug-overrides">&lt;debug-overrides&gt;</h3>

<dl class="xml">
  <dt>
    sintaxis:
  </dt>

  <dd>
    <pre class="stx">
&lt;debug-overrides&gt;
    ...
&lt;/debug-overrides&gt;
</pre>
  </dd>

  <dt>
    PUEDE CONTENER:
  </dt>

  <dd>
    0 o 1 <code><a href="#trust-anchors">&lt;trust-anchors&gt;</a></code>
  </dd>

  <dt>
    DESCRIPCIN:
  </dt>

  <dd>
    Sobrescrituras que se deben aplicar cuando <a href="{@docRoot}guide/topics/manifest/application-element.html#debug">android:debuggable</a>
 es {@code "true"}, que es, generalmente, el caso de las compilaciones que no sean de lanzamiento
 generadas por herramientas de IDE y de compilacin. Los anclajes de confianza especificados en {@code
 debug-overrides} se agregan a todas las dems configuraciones, y la fijacin
 de certificados no se lleva a cabo cuando la cadena de certificados del servidor usa uno de estos
 anclajes de confianza de solo depuracin. Si <a href="{@docRoot}guide/topics/manifest/application-element.html#debug">android:debuggable</a>
 es {@code "false"}, entonces, esta seccin se omite por completo.
  </dd>
</dl>

<h3 id="trust-anchors">&lt;trust-anchors&gt;</h3>
<dl class="xml">
  <dt>
    SINTAXIS:
  </dt>

  <dd>
    <pre class="stx">
&lt;trust-anchors&gt;
...
&lt;/trust-anchors&gt;
</pre>
  </dd>

  <dt>
    PUEDE CONTENER:
  </dt>

  <dd>
    Cualquier cantidad de <code><a href="#certificates">&lt;certificates&gt;</a></code>
  </dd>

  <dt>
    DESCRIPCIN:
  </dt>

  <dd>
    Conjunto de anclajes de confianza para conexiones seguras.
  </dd>
</dl>


<h3 id="certificates">&lt;certificates&gt;</h3>
<dl class="xml">
<dt>SINTAXIS:</dt>
<dd><pre class="stx">&lt;certificates src=["system" | "user" | "<i>raw resource</i>"]
              overridePins=["true" | "false"] /&gt;
</pre></dd>
<dt>DESCRIPCIN:</dt>
<dd>Conjunto de certificados X.509 para elementos de {@code trust-anchors}.</dd>

<dt>ATRIBUTOS:</dt>
<dd><dl class="attr">
<dt>{@code src}</dt>
<dd>
La fuente de los certificados de CA puede ser una de las siguientes opciones:
<ul>
  <li>Una ID de recurso sin procesar que apunta a un archivo que contiene certificados X.509.
  Los certificados deben estar codificados en formato DER o PEM. En el caso de los certificados
 PEM, el archivo <em>no debe</em> contener datos adicionales que no sean de PEM, como
 comentarios.
  </li>

  <li>{@code "system"} para los certificados de CA preinstalados del sistema.
  </li>

  <li>{@code "user"} para los certificados de CA agregados por el usuario.
  </li>
</ul>
</dd>

<dt>{@code overridePins}</dt>
<dd>
  <p>
    Especifica si las CA de esta fuente omiten la fijacin de certificados. Si es {@code
"true"}, las cadenas de certificados se encadenan mediante una de estas CA
 desde esta fuente, y la fijacin no se lleva a cabo. Esto puede ser til para CA de depuracin
 o para poder permitirle al usuario hacer un ataque MiTM al trfico seguro de la aplicacin.
  </p>

  <p>
    Es {@code "false"} de forma predeterminada, a menos que se especifique en un elemento de {@code debug-overrides}
, en cuyo caso, es {@code "true"} de forma predeterminada.
  </p>
</dd>
</dl>
</dd>


<h3 id="pin-set">&lt;pin-set&gt;</h3>

<dl class="xml">
  <dt>
    SINTAXIS:
  </dt>

  <dd>
<pre class="stx">
&lt;pin-set expiration="date"&gt;
...
&lt;/pin-set&gt;
</pre>
  </dd>

  <dt>
    PUEDE CONTENER:
  </dt>

  <dd>
    Cualquier cantidad de <code><a href="#pin">&lt;pin&gt;</a></code>
  </dd>

  <dt>
    DESCRIPCIN:
  </dt>

  <dd>
    Un conjunto de fijaciones de claves pblicas. Para que una conexin segura sea de confianza, una de las
 claves pblicas de la cadena de confianza debe estar en el conjunto de fijaciones. Consulta
 <code><a href="#pin">&lt;pin&gt;</a></code> para el formato de las fijaciones.
  </dd>

  <dt>
    ATRIBUTOS:
  </dt>

  <dd>
    <dl class="attr">
      <dt>
        {@code expiration}
      </dt>

      <dd>
        La fecha, en formato {@code yyyy-MM-dd}, a partir de la cual
 expiran las fijaciones, lo cual deshabilita la fijacin. Si el atributo no est establecido, las fijaciones
 no expiran.
        <p>
          La expiracin ayuda a evitar problemas de conectividad en aplicaciones que no
 reciben actualizaciones para el conjunto de fijaciones, por ejemplo, porque el usuario
 deshabilit las actualizaciones de la aplicacin.
        </p>
      </dd>
    </dl>
  </dd>
</dl>

<h3 id="pin">&lt;pin&gt;</h3>
<dl class="xml">
  <dt>
    sintaxis:
  </dt>

  <dd>
<pre class="stx">
&lt;pin digest=["SHA-256"]&gt;base64 encoded digest of X.509
    SubjectPublicKeyInfo (SPKI)&lt;/pin&gt;
</pre>
  </dd>

  <dt>
    ATRIBUTOS:
  </dt>

  <dd>
    <dl class="attr">
      <dt>
        {@code digest}
      </dt>

      <dd>
        Resumen del algoritmo usado para generar la fijacin. Actualmente, solo se admite
 {@code "SHA-256"}.
      </dd>
    </dl>
  </dd>
</dl>