package pgpmail
import "github.com/emersion/go-pgpmail"
Package pgpmail implements PGP encryption for e-mail messages.
PGP/MIME is defined in RFC 3156.
Index ¶
- func Encrypt(w io.Writer, h textproto.Header, to []*openpgp.Entity, signed *openpgp.Entity, config *packet.Config) (io.WriteCloser, error)
- func Sign(w io.Writer, header textproto.Header, signed *openpgp.Entity, config *packet.Config) (io.WriteCloser, error)
- type Reader
Examples ¶
Functions ¶
func Encrypt ¶
func Encrypt(w io.Writer, h textproto.Header, to []*openpgp.Entity, signed *openpgp.Entity, config *packet.Config) (io.WriteCloser, error)
Example¶
Code:
{
// to are the recipients' keys, signer is the sender's key
var to []*openpgp.Entity
var signer *openpgp.Entity
var mailHeader mail.Header
mailHeader.SetAddressList("From", []*mail.Address{{"Mitsuha Miyamizu", "mitsuha.miyamizu@example.org"}})
mailHeader.SetAddressList("To", []*mail.Address{{"Taki Tachibana", "taki.tachibana@example.org"}})
var encryptedHeader mail.Header
encryptedHeader.SetContentType("text/plain", nil)
encryptedText := "Hi! I'm Mitsuha Miyamizu."
var buf bytes.Buffer
cleartext, err := pgpmail.Encrypt(&buf, mailHeader.Header.Header, to, signer, nil)
if err != nil {
log.Fatal(err)
}
defer cleartext.Close()
body, err := mail.CreateSingleInlineWriter(cleartext, encryptedHeader)
if err != nil {
log.Fatal(err)
}
defer body.Close()
if _, err := io.WriteString(body, encryptedText); err != nil {
log.Fatal(err)
}
if err := body.Close(); err != nil {
log.Fatal(err)
}
if err := cleartext.Close(); err != nil {
log.Fatal(err)
}
log.Print(buf.String())
}
func Sign ¶
func Sign(w io.Writer, header textproto.Header, signed *openpgp.Entity, config *packet.Config) (io.WriteCloser, error)
Example¶
Code:
{
// signer is the sender's key
var signer *openpgp.Entity
var mailHeader mail.Header
mailHeader.SetAddressList("From", []*mail.Address{{"Mitsuha Miyamizu", "mitsuha.miyamizu@example.org"}})
mailHeader.SetAddressList("To", []*mail.Address{{"Taki Tachibana", "taki.tachibana@example.org"}})
var signedHeader mail.Header
signedHeader.SetContentType("text/plain", nil)
signedText := "Hi! I'm Mitsuha Miyamizu."
var buf bytes.Buffer
cleartext, err := pgpmail.Sign(&buf, mailHeader.Header.Header, signer, nil)
if err != nil {
log.Fatal(err)
}
defer cleartext.Close()
body, err := mail.CreateSingleInlineWriter(cleartext, signedHeader)
if err != nil {
log.Fatal(err)
}
defer body.Close()
if _, err := io.WriteString(body, signedText); err != nil {
log.Fatal(err)
}
if err := body.Close(); err != nil {
log.Fatal(err)
}
if err := cleartext.Close(); err != nil {
log.Fatal(err)
}
log.Print(buf.String())
}
Types ¶
type Reader ¶
type Reader struct { Header textproto.Header MessageDetails *openpgp.MessageDetails }
func NewReader ¶
func NewReader(h textproto.Header, body io.Reader, keyring openpgp.KeyRing, prompt openpgp.PromptFunction, config *packet.Config) (*Reader, error)
func Read ¶
func Read(r io.Reader, keyring openpgp.KeyRing, prompt openpgp.PromptFunction, config *packet.Config) (*Reader, error)
Example¶
Code:
{ // Let's assume r contains an e-mail, which is maybe encrypted or signed var r io.Reader // A private key is needed in case the message is encrypted var privateKey *openpgp.Entity pgpReader, err := pgpmail.Read(r, openpgp.EntityList{privateKey}, nil, nil) if err != nil { log.Fatal(err) } log.Printf("Header: %v", pgpReader.Header) // pgpReader.MessageDetails.UnverifiedBody contains the whole wrapped e-mail entity, err := message.Read(pgpReader.MessageDetails.UnverifiedBody) if err != nil { log.Fatal(err) } // Do something with the wrapped e-mail log.Printf("Wrapped header: %v", entity.Header) var buf bytes.Buffer if _, err := io.Copy(&buf, entity.Body); err != nil { log.Fatal(err) } // Now that the wrapped e-mail has been read, we can check the signature. // We can only do this if the wrapped e-mail has been fully consumed. if err := pgpReader.MessageDetails.SignatureError; err != nil { log.Fatal(err) } log.Printf("Signed: %v", pgpReader.MessageDetails.IsSigned) log.Printf("Encrypted: %v", pgpReader.MessageDetails.IsEncrypted) }
Source Files ¶
pgpmail.go reader.go writer.go
- Version
- v0.2.2 (latest)
- Published
- Jan 13, 2025
- Platform
- linux/amd64
- Imports
- 14 packages
- Last checked
- 1 day ago –
Tools for package owners.