training/articles/security-config.jd

page.title=Configurao de segurana de rede
page.keywords=androidn,security,network
page.image=images/cards/card-nyc_2x.jpg

@jd:body

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

<h2>Neste documento</h2>
<ol>
  <li><a href="#manifest">Adicionar um arquivo de configuraes de segurana</a></li>
  <li><a href="#CustomTrust">Personalizar CAs confiveis</a>
      <ol>
      <li><a href="#ConfigCustom">Configurar uma CA personalizada confivel</a></li>
      <li><a href="#LimitingCas">Limitar o conjunto de CAs confiveis</a></li>
      <li><a href="#TrustingAdditionalCas">Confiar em CAs adicionais</a></li>
      </ol>
  </li>
  <li><a href="#TrustingDebugCa">CAs somente de depurao</a></li>
  <li><a href="#UsesCleartextTraffic">Cancelar uso de trfego de texto simples</a></li>
  <li><a href="#CertificatePinning">Fixar certificados</a></li>
  <li><a href="#ConfigInheritance">Comportamento de herana de configurao</a></li>
  <li><a href="#FileFormat">Formato do arquivo de configuraes</a></li>
</ol>
</div>
</div>


<p>
  O Android N inclui um recurso de configuraes de segurana de rede
 que permite que os aplicativos personalizem as configuraes de segurana de rede em um arquivo de configuraes declarativo e seguro
 sem modificar o cdigo do aplicativo. Essas configuraes podem
 ser definidas para domnios especficos e para um aplicativo especfico. Os principais
 recursos so:
</p>

<ul>
  <li>
    <b>ncoras de confiana personalizadas:</b> personalize quais autoridades de certificado (CA)
 so confiveis para as conexes seguras de um aplicativo. Por
 exemplo, confiar em certificados autoassinados privados ou restringir
 o conjunto de CAs pblicas nas quais o aplicativo confia.
  </li>

  <li>
    <b>Substituies somente de depurao:</b> depure conexes seguras do aplicativo com segurana,
 sem adicionar riscos  base instalada.
  </li>

  <li>
    <b>Cancelar uso de trfego de texto simples:</b> proteja aplicativos contra
 o uso acidental de trfego de texto simples.
  </li>

  <li>
    <b>Fixar certificados:</b> restrinja a conexo segura de um aplicativo
 a certificados especficos.
  </li>
</ul>


<h2 id="manifest">Adicionar um arquivo de configuraes de segurana</h2>

<p>
  O recurso de configuraes de segurana de rede usa um arquivo XML no qual voc especifica
 as configuraes do seu aplicativo. Inclua uma entrada no manifesto do seu
 aplicativo para apontar para esse arquivo. Este trecho de cdigo de um manifesto
 demonstra como criar essa 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 CAs confiveis</h2>

<p>
  Um aplicativo pode querer confiar em um conjunto personalizado de CAs em vez de no padro
 da plataforma. Os motivos mais comuns para isso so:
</p>

<ul>
  <li>Conectar-se a um host com uma autoridade de certificado personalizada (autoassinada,
 emitida por uma CA corporativa interna etc.).
  </li>

  <li>Limitar o conjunto de CAs para apenas aquelas nas quais voc confia em vez de todas
 as CAs pr-instaladas.
  </li>

  <li>Confiar em CAs adicionais no includas no sistema.
  </li>
</ul>

<p>
  Por padro, conexes seguras (por exemplo, TLS, HTTPS) de todos os aplicativos confiam
 nas CAs pr-instaladas do sistema e os aplicativos direcionados ao nvel da API 23
 (Android M) e inferior tambm confiam no repositrio de CAs adicionadas pelo usurio por padro. Um
 aplicativo pode personalizar as prprias conexes usando {@code base-config} (para
 personalizao em todo o aplicativo) ou {@code domain-config} (para personalizao
 por domnio).
</p>


<h3 id="ConfigCustom">Configurar uma CA personalizada</h3>

<p>
  Suponhamos que voc queira se conectar a um host que use um certificado SSL autoassinado
 ou a um host cujo certificado SSL foi emitido por uma CA no pblica
 na qual confia, como a CA interna da sua 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>
  Adicione o certificado da CA autoassinada ou no pblica em formato PEM ou DER em
 {@code res/raw/my_ca}.
</p>


<h3 id="LimitingCas">Limitar o conjunto de CAs confiveis</h3>

<p>
  Um aplicativo que no queira confiar em todas as CAs nas quais o sistema confia
 pode especificar o prprio conjunto limitado de CAs confiveis. Isso protege o
 aplicativo contra certificados fraudulentos emitidos por qualquer outra CA.
</p>

<p>
  A configurao para limitar o conjunto de CAs confiveis  semelhante a <a href="#TrustingACustomCa">confiar em uma CA personalizada</a> para um domnio especfico, mas
 fornecendo vrias CAs no 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>
  Adicione as CAs confiveis em formato PEM ou DER em {@code res/raw/trusted_roots}.
  Observe que, ao usar o formato PEM, o arquivo deve conter <em>somente</em> dados PEM,
 sem texto adicional. Voc tambm pode fornecer vrios elementos
 <a href="#certificates"><code>&lt;certificates&gt;</code></a>
em vez de um.
</p>


<h3 id="TrustingAdditionalCas">
  Confiar em CAs adicionais
</h3>

<p>
  Um aplicativo pode querer confiar em CAs adicionais nas quais o sistema no confia.
 Isso pode ocorrer se o sistema ainda no incluiu a CA ou se a CA
 no atender aos requisitos de incluso no sistema Android. O
 aplicativo pode fazer isso ao especificar vrias fontes de certificados para uma
 configurao.
</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 CAs para depurao</h2>

<p>
  Ao depurar um aplicativo conectado por HTTPS, voc pode querer
 se conectar a um servidor de desenvolvimento local que no tenha o certificado SSL
 do seu servidor de produo. Para fazer isso sem
 modificar o cdigo do aplicativo, voc pode especificar CAs somente de depurao que
 sejam confiveis <i>apenas</i> quando <a href="{@docRoot}guide/topics/manifest/application-element.html#debug">
android:debuggable</a>
 for {@code true} ao usar {@code debug-overrides}. Normalmente, IDEs e ferramentas de compilao
 definem esse sinalizador automaticamente para compilaes de no lanamento.
</p>

<p>
  Isso  mais seguro do que o cdigo condicional normal, pois, como medida
 de segurana, os repositrios do aplicativo no aceitam aplicativos marcados como
 depurveis.
</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">Cancelar uso de trfego de texto simples</h2>

<p>
  Aplicativos que pretendem se conectar a destinos usando apenas conexes
 seguras podem cancelar o uso de texto simples de suporte (usando o protocolo HTTP no criptografado
 em vez de HTTPS) para esses destinos. Essa opo ajuda a evitar
 regresses acidentais em aplicativos devido a alteraes nos URLs fornecidos por fontes externas,
 como servidores de back-end.
  Consulte {@link android.security.NetworkSecurityPolicy#isCleartextTrafficPermitted
  NetworkSecurityPolicy.isCleartextTrafficPermitted()} para saber mais.
</p>

<p>
  Por exemplo, um aplicativo pode querer garantir que todas as conexes com {@code
  secure.example.com} sejam sempre realizadas por HTTPS para proteger o trfego confidencial
 de redes hostis.
</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">Fixar certificados</h2>

<p>
  Normalmente, um aplicativo confia em todas as CAs pr-instaladas. Se qualquer uma dessas CAs
 emitir um certificado fraudulento, o aplicativo estar em risco de ataques
 MiTM. Alguns aplicativos optam por limitar o conjunto de certificados que aceitam
 restringindo o conjunto de CAs ou fixando certificados.
</p>

<p>
  A fixao de certificados  realizada ao fornecer um conjunto de certificados pelo hash da
 chave pblica (SubjectPublicKeyInfo do certificado X.509). Uma cadeia de certificados
  vlida somente se contiver pelo menos uma
 das chaves pblicas fixadas.
</p>

<p>
  Observe que, ao usar a fixao de certificados, voc deve sempre incluir uma chave de backup
 para que, se voc for forado a alternar para novas chaves ou alterar as CAs (ao
 fixar um certificado de CA ou um intermedirio dessa CA), a
 conectividade do seu aplicativo no seja afetada. Caso contrrio, voc precisar enviar
 uma atualizao ao aplicativo para restaurar a conectividade.
</p>

<p>
  Alm disso,  possvel definir um tempo de expirao para as fixaes, aps o qual
 elas no sejam mais realizadas. Isso ajuda a evitar problemas de conectividade
 em aplicativos que no foram atualizados. No entanto, definir um tempo de expirao
 para fixaes pode permitir que as fixaes sejam ignoradas.
</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">Comportamento de herana de configurao</h2>

<p>
  Valores no definidos em uma configurao especfica so herdados. Esse comportamento permite
 configuraes mais complexas, mantendo o arquivo de configurao legvel.
</p>

<p>
  Se um valor no for definido em uma entrada especfica, o valor da prxima entrada
 mais genrica ser usado. Valores no definidos em um {@code domain-config} so
 obtidos pelo {@code domain-config} pai, se aninhados, ou, caso contrrio, pelo {@code
  base-config}. Valores no definidos no {@code base-config} usam os
 valores padro da plataforma.
</p>

<p>
  Por exemplo, considere um caso no qual todas as conexes para subdomnios de {@code
  example.com} devem usar um conjunto personalizado de CAs. Alm disso, o trfego de texto simples para esses
 domnios  permitido <em>exceto</em> ao se conectar com {@code
  secure.example.com}. Ao aninhar a configurao para {@code
  secure.example.com} dentro da configurao para {@code example.com}, o
 {@code trust-anchors} no precisa ser duplicado.
</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 do arquivo de configuraes</h2>

<p>
  O recurso de configuraes de segurana de rede usa um formato do arquivo XML.
  A estrutura geral desse arquivo  mostrada no seguinte exemplo 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>
  As sees a seguir descrevem a sintaxe e outros detalhes do formato do
 arquivo.
</p>

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

<dl class="xml">
  <dt>
    pode conter:
  </dt>

  <dd>
    0 ou 1 de <code><a href="#base-config">&lt;base-config&gt;</a></code><br>
    Qualquer nmero de <code><a href=
    "#domain-config">&lt;domain-config&gt;</a></code><br>
    0 ou 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>
    sintaxe:
  </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>
    pode conter:
  </dt>

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

  <dt>
    descrio:
  </dt>

  <dd>
    A configurao padro usada por todas as conexes cujo destino no
 coberto por um <a href="#domain-config"><code>domain-config</code></a>.

<p>
  Qualquer valor no definido usa os valores padro da plataforma. A configurao padro
 para aplicativos direcionados a nveis de API acima do 24:
</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>
A configurao padro para aplicativos direcionados a nveis de API 23 e inferiores:
<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>sintaxe:</dt>
<dd>
<pre class="stx">&lt;domain-config <a href="#usesCleartextTraffic">usesCleartextTraffic</a>=["true" | "false"]&gt;
    ...
&lt;/domain-config&gt;</pre>
</dd>

<dt>Pode conter:</dt>

<dd>
1 ou mais <code><a href="#domain">&lt;domain&gt;</a></code>
<br/>0 ou 1 <code><a href="#trust-anchors">&lt;trust-anchors&gt;</a></code>
<br/>0 ou 1 <code><a href="#pin-set">&lt;pin-set&gt;</code></a>
<br/>Qualquer nmero de <code>&lt;domain-config&gt;</code> aninhados</dd>

<dt>Descrio</dt>
<dd>A configurao usada para conexes com destinos especficos, conforme  definido pelos elementos {@code domain}.

<p>Observe que, se vrios elementos {@code domain-config} cobrirem um destino, a configurao com a regra de domnio correspondente
mais especfica (mais longa) ser usada.</p></dd>
</dl>


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

<dl class="xml">
  <dt>
    sintaxe:
  </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>
        Se {@code "true"}, a regra de domnio corresponder ao domnio e a todos os
 subdomnios, incluindo subdomnios de subdomnios. Caso contrrio, a regra
 se aplica apenas a correspondncias exatas.
      </dd>
    </dl>
  </dd>

  <dt>
    Descrio:
  </dt>
</dl>

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

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

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

  <dt>
    Pode conter:
  </dt>

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

  <dt>
    Descrio:
  </dt>

  <dd>
    Substituies a serem aplicadas quando <a href="{@docRoot}guide/topics/manifest/application-element.html#debug">android:debuggable</a>
 for {@code "true"}, o que normalmente ocorre em compilaes de no lanamento
 geradas por IDEs e ferramentas de compilao. ncoras de confiana especificadas em {@code
    debug-overrides} so adicionadas a todas as demais configuraes e a fixao
 de certificados no  realizada quando a cadeia de certificados do servidor usa uma
 dessas ncoras de confiana somente de depurao. Se <a href="{@docRoot}guide/topics/manifest/application-element.html#debug">android:debuggable</a>
 for {@code "false"}, esta seo ser ignorada por completo.
  </dd>
</dl>

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

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

  <dt>
    Pode conter:
  </dt>

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

  <dt>
    Descrio:
  </dt>

  <dd>
    Conjunto de ncoras de confiana para conexes seguras.
  </dd>
</dl>


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

<dt>atributos:</dt>
<dd><dl class="attr">
<dt>{@code src}</dt>
<dd>
A fonte de certificados de CA, que pode ser um dos
<ul>
  <li>IDs de recursos brutos que apontam para um arquivo que contm certificados X.509.
  Os certificados devem ser codificados em formato DER ou PEM. No caso de certificados PEM,
 o arquivo <em>no deve</em> conter dados no PEM adicionais, como
 comentrios.
  </li>

  <li>{@code "system"} para os certificados de CA pr-instalados do sistema
  </li>

  <li>{@code "user"} para certificados de CA adicionados pelo usurio
  </li>
</ul>
</dd>

<dt>{@code overridePins}</dt>
<dd>
  <p>
    Especifica se as CAs dessa fonte ignoram a fixao de certificados. Se {@code
    true} e forem certificadas cadeias de certificados que incluam uma das CAs dessa
 fonte, a fixao no ser realizada. Isso pode ser til para depurar CAs
 ou permitir que o usurio execute ataques MiTM no trfego seguro do seu aplicativo.
  </p>

  <p>
    O padro  {@code "false"} a no ser que seja especificado em um elemento {@code debug-overrides}
. Nesse caso, o padro ser {@code "true"}.
  </p>
</dd>
</dl>
</dd>


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

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

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

  <dt>
    Pode conter:
  </dt>

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

  <dt>
    Descrio:
  </dt>

  <dd>
    Um conjunto de fixaes de chave pblica. Para que uma conexo segura seja confivel, uma das
 chaves pblicas na cadeia de confiana deve estar presente no conjunto de fixaes. Consulte
 <code><a href="#pin">&lt;pin&gt;</a></code> para saber mais sobre o formato das fixaes.
  </dd>

  <dt>
    Atributos:
  </dt>

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

      <dd>
        A data, no formato {@code yyyy-MM-dd}, aps a qual as fixaes
 expiram e so desativadas. Se o atributo no for definido, as fixaes
 no expiraro.
        <p>
          A expirao ajuda a evitar problemas de conectividade em aplicativos que no
 recebem atualizaes para o conjunto de fixaes, por exemplo, porque o usurio
 desativou as atualizaes do aplicativo.
        </p>
      </dd>
    </dl>
  </dd>
</dl>

<h3 id="pin">&lt;pin&gt;</h3>
<dl class="xml">
  <dt>
    sintaxe:
  </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>
        O algoritmo de resumo usado para gerar a fixao. No momento, apenas
 {@code "SHA-256"}  permitido.
      </dd>
    </dl>
  </dd>
</dl>