Пакет pem

• import "encoding/pem"
• Обзор
• Индекс
• Примеры

Обзор

Пакет pem реализует кодирование данных PEM, которое зародилось в Privacy Enhanced Mail. Наиболее распространённое использование кодирования PEM в настоящее время — в TLS-ключах и сертификатах. См. RFC 1421.

Индекс

• func Encode(out io.Writer, b *Block) error
• func EncodeToMemory(b *Block) []byte
• тип Block
• func Decode(data []byte) (p *Block, rest []byte)

Файлы пакета

pem.go

func Encode

func Encode(out io.Writer, b *Block) error

Encode записывает PEM-кодирование b в out.

Пример

Код:

block := &pem.Block{
    Type: "MESSAGE",
    Headers: map[string]string{
        "Animal": "Gopher",
    },
    Bytes: []byte("test"),
}

if err := pem.Encode(os.Stdout, block); err != nil {
    log.Fatal(err)
}

Вывод:

-----BEGIN MESSAGE-----
Animal: Gopher

dGVzdA==
-----END MESSAGE-----

func EncodeToMemory

func EncodeToMemory(b *Block) []byte

EncodeToMemory возвращает PEM-кодирование b.

Если у b есть недопустимые заголовки и его нельзя закодировать, EncodeToMemory возвращает nil. Если важно сообщить подробности об этом случае ошибки, используйте Encode вместо этого.

тип Block

Block представляет структуру, закодированную в PEM.

Кодированная форма:

-----BEGIN Type-----
Headers
base64-encoded Bytes
-----END Type-----

где [Block.Headers] — это, возможно, пустая последовательность строк Key: Value.

type Block struct {
    Type    string            // The type, taken from the preamble (i.e. "RSA PRIVATE KEY").
    Headers map[string]string // Optional headers.
    Bytes   []byte            // The decoded bytes of the contents. Typically a DER encoded ASN.1 structure.
}

func Decode

func Decode(data []byte) (p *Block, rest []byte)

Decode найдёт следующий блок в формате PEM (сертификат, закрытый ключ и т. д.) в вводе. Он возвращает этот блок и остальную часть ввода. Если данные PEM не найдены, p равен nil, а весь ввод возвращается в rest.

Пример

Код:

var pubPEMData = []byte(`
-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAlRuRnThUjU8/prwYxbty
WPT9pURI3lbsKMiB6Fn/VHOKE13p4D8xgOCADpdRagdT6n4etr9atzDKUSvpMtR3
CP5noNc97WiNCggBjVWhs7szEe8ugyqF23XwpHQ6uV1LKH50m92MbOWfCtjU9p/x
qhNpQQ1AZhqNy5Gevap5k8XzRmjSldNAFZMY7Yv3Gi+nyCwGwpVtBUwhuLzgNFK/
yDtw2WcWmUU7NuC8Q6MWvPebxVtCfVp/iQU6q60yyt6aGOBkhAX0LpKAEhKidixY
nP9PNVBvxgu3XZ4P36gZV6+ummKdBVnc3NqwBLu5+CcdRdusmHPHd5pHf4/38Z3/
6qU2a/fPvWzceVTEgZ47QjFMTCTmCwNt29cvi7zZeQzjtwQgn4ipN9NibRH/Ax/q
TbIzHfrJ1xa2RteWSdFjwtxi9C20HUkjXSeI4YlzQMH0fPX6KCE7aVePTOnB69I/
a9/q96DiXZajwlpq3wFctrs1oXqBp5DVrCIj8hU2wNgB7LtQ1mCtsYz//heai0K9
PhE4X6hiE0YmeAZjR0uHl8M/5aW9xCoJ72+12kKpWAa0SFRWLy6FejNYCYpkupVJ
yecLk/4L1W0l6jQQZnWErXZYe0PNFcmwGXy1Rep83kfBRNKRy5tvocalLlwXLdUk
AIU+2GKjyT3iMuzZxxFxPFMCAwEAAQ==
-----END PUBLIC KEY-----
and some more`)

block, rest := pem.Decode(pubPEMData)
if block == nil || block.Type != "PUBLIC KEY" {
    log.Fatal("failed to decode PEM block containing public key")
}

pub, err := x509.ParsePKIXPublicKey(block.Bytes)
if err != nil {
    log.Fatal(err)
}

fmt.Printf("Got a %T, with remaining data: %q", pub, rest)

Вывод:

Got a *rsa.PublicKey, with remaining data: "and some more"