1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96
|
// Modifier instance is provided to milter handlers to modify email messages
package milter
import (
"bytes"
"encoding/binary"
"fmt"
"net/textproto"
)
// postfix wants LF lines endings. Using CRLF results in double CR sequences.
func crlfToLF(b []byte) []byte {
return bytes.ReplaceAll(b, []byte{'\r', '\n'}, []byte{'\n'})
}
// Modifier provides access to Macros, Headers and Body data to callback handlers. It also defines a
// number of functions that can be used by callback handlers to modify processing of the email message
type Modifier struct {
Macros map[string]string
Headers textproto.MIMEHeader
writePacket func(*Message) error
}
// AddRecipient appends a new envelope recipient for current message
func (m *Modifier) AddRecipient(r string) error {
data := []byte(fmt.Sprintf("<%s>", r) + null)
return m.writePacket(NewResponse('+', data).Response())
}
// DeleteRecipient removes an envelope recipient address from message
func (m *Modifier) DeleteRecipient(r string) error {
data := []byte(fmt.Sprintf("<%s>", r) + null)
return m.writePacket(NewResponse('-', data).Response())
}
// ReplaceBody substitutes message body with provided body
func (m *Modifier) ReplaceBody(body []byte) error {
body = crlfToLF(body)
return m.writePacket(NewResponse('b', body).Response())
}
// AddHeader appends a new email message header the message
func (m *Modifier) AddHeader(name, value string) error {
var buffer bytes.Buffer
buffer.WriteString(name + null)
buffer.Write(crlfToLF([]byte(value)))
buffer.WriteString(null)
return m.writePacket(NewResponse('h', buffer.Bytes()).Response())
}
// Quarantine a message by giving a reason to hold it
func (m *Modifier) Quarantine(reason string) error {
return m.writePacket(NewResponse('q', []byte(reason+null)).Response())
}
// ChangeHeader replaces the header at the specified position with a new one.
// The index is per name.
func (m *Modifier) ChangeHeader(index int, name, value string) error {
var buffer bytes.Buffer
if err := binary.Write(&buffer, binary.BigEndian, uint32(index)); err != nil {
return err
}
buffer.WriteString(name + null)
buffer.Write(crlfToLF([]byte(value)))
buffer.WriteString(null)
return m.writePacket(NewResponse('m', buffer.Bytes()).Response())
}
// InsertHeader inserts the header at the specified position
func (m *Modifier) InsertHeader(index int, name, value string) error {
var buffer bytes.Buffer
if err := binary.Write(&buffer, binary.BigEndian, uint32(index)); err != nil {
return err
}
buffer.WriteString(name + null)
buffer.Write(crlfToLF([]byte(value)))
buffer.WriteString(null)
return m.writePacket(NewResponse('i', buffer.Bytes()).Response())
}
// ChangeFrom replaces the FROM envelope header with a new one
func (m *Modifier) ChangeFrom(value string) error {
data := []byte(value + null)
return m.writePacket(NewResponse('e', data).Response())
}
// newModifier creates a new Modifier instance from milterSession
func newModifier(s *milterSession) *Modifier {
return &Modifier{
Macros: s.macros,
Headers: s.headers,
writePacket: s.WritePacket,
}
}
|