github.com/rstandt/terraform@v0.12.32-0.20230710220336-b1063613405c/website/docs/configuration/functions/base64sha512.html.md (about)

     1  ---
     2  layout: "functions"
     3  page_title: "base64sha512 - Functions - Configuration Language"
     4  sidebar_current: "docs-funcs-crypto-base64sha512"
     5  description: |-
     6    The base64sha512 function computes the SHA512 hash of a given string and
     7    encodes it with Base64.
     8  ---
     9  
    10  # `base64sha512` Function
    11  
    12  -> **Note:** This page is about Terraform 0.12 and later. For Terraform 0.11 and
    13  earlier, see
    14  [0.11 Configuration Language: Interpolation Syntax](../../configuration-0-11/interpolation.html).
    15  
    16  `base64sha512` computes the SHA512 hash of a given string and encodes it with
    17  Base64. This is not equivalent to `base64encode(sha512("test"))` since `sha512()`
    18  returns hexadecimal representation. 
    19  
    20  The given string is first encoded as UTF-8 and then the SHA512 algorithm is applied
    21  as defined in [RFC 4634](https://tools.ietf.org/html/rfc4634). The raw hash is
    22  then encoded with Base64 before returning. Terraform uses the "standard" Base64
    23  alphabet as defined in [RFC 4648 section 4](https://tools.ietf.org/html/rfc4648#section-4).
    24  
    25  ## Examples
    26  
    27  ```
    28  > base64sha512("hello world")
    29  MJ7MSJwS1utMxA9QyQLytNDtd+5RGnx6m808qG1M2G+YndNbxf9JlnDaNCVbRbDP2DDoH2Bdz33FVC6TrpzXbw==
    30  ```
    31  
    32  ## Related Functions
    33  
    34  * [`filebase64sha512`](./filebase64sha512.html) calculates the same hash from
    35    the contents of a file rather than from a string value.
    36  * [`sha512`](./sha512.html) calculates the same hash but returns the result
    37    in a more-verbose hexadecimal encoding.