giskh_xmlsig

package module
v0.0.0-...-3984091 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 25, 2026 License: MIT Imports: 11 Imported by: 0

README

ГИС ЖКХ XML Digital Signature

Библиотека для создания XML цифровых подписей соответствующих требованиям ГИС ЖКХ (Государственная информационная система жилищно-коммунального хозяйства).

Особенности

  • Поддержка ГИС ЖКХ: Реализует профиль XMLDSig для интеграции с ГИС ЖКХ
  • XAdES-BES: Поддержка расширенных электронных подписей
  • SOAP конверты: Работа с SOAP документами с правильными namespace
  • EXC-C14N: Правильная эксклюзивная каноникализация XML
  • Алгоритмы ГОСТ: Заготовка для алгоритмов ГОСТ Р 34.10-2001/34.11-94
  • RSA поддержка: Полная поддержка RSA для тестирования

Структура

├── signer.go          # Основная функция подписания
├── types.go           # Структуры данных XMLDSig и SOAP
├── canonicalize.go    # Каноникализация XML (EXC-C14N)
├── gost.go            # Поддержка алгоритмов ГОСТ (заглушки)
├── example/
│   └── main.go        # Пример использования
└── README.md

Установка

go get github.com/Pavel-Vinogradov/giskh-xmlsig

Использование

Базовое использование
package main

import (
    "crypto/x509"
    "github.com/Pavel-Vinogradov/giskh-xmlsig"
)

func main() {
    // Загрузка сертификата и приватного ключа
    cert, privateKey := loadCertificate()
    
    // SOAP документ для подписания
    soapXML := `<?xml version="1.0" encoding="UTF-8"?>
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
        <soapenv:Header/>
        <soapenv:Body>
            <!-- Данные ГИС ЖКХ -->
        </soapenv:Body>
    </soapenv:Envelope>`
    
    // Подписание документа
    signedXML, err := giskh_xmlsig.SignXMLGIS([]byte(soapXML), cert, privateKey)
    if err != nil {
        panic(err)
    }
    
    println(string(signedXML))
}
Пример запуска
cd example
go run main.go

Структура подписи

Библиотека создает подписи соответствующие профилю ГИС ЖКХ:

<ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="xmldsig">
    <ds:SignedInfo>
        <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
        <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gostr34102001-gostr3411"/>
        <ds:Reference URI="#Body">
            <ds:Transforms>
                <ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
                <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
            </ds:Transforms>
            <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#gostr3411"/>
            <ds:DigestValue>...</ds:DigestValue>
        </ds:Reference>
    </ds:SignedInfo>
    <ds:SignatureValue>...</ds:SignatureValue>
    <ds:KeyInfo>
        <ds:X509Data>
            <ds:X509Certificate>...</ds:X509Certificate>
        </ds:X509Data>
    </ds:KeyInfo>
    <ds:Object>
        <xades:QualifyingProperties Target="#xmldsig" xmlns:xades="http://uri.etsi.org/01903/v1.3.2#">
            <!-- XAdES-BES свойства -->
        </xades:QualifyingProperties>
    </ds:Object>
</ds:Signature>

Алгоритмы

Поддерживаемые алгоритмы
  • RSA-SHA256: Полная поддержка
  • ГОСТ Р 34.10-2001/34.11-94: Заглушки (требует библиотеку ГОСТ)
Каноникализация
  • EXC-C14N: Эксклюзивная каноникализация
  • Enveloped Signature: Удаление вложенных подписей

Требования ГИС ЖКХ

Библиотека соответствует требованиям:

  1. Профиль OASIS Standard 200401 с X.509 Certificate Token Profile
  2. XAdES-BES (XML Advanced Electronic Signature - Basic Electronic Signature)
  3. SOAP конверты с правильными namespace
  4. Трансформации данных перед подписанием
  5. Алгоритмы ГОСТ (заглушки для реализации)

Зависимости

require (
    github.com/beevik/etree v1.6.0
)

Лицензия

MIT License

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func CanonicalizeEXC14N

func CanonicalizeEXC14N(elem *etree.Element, inclusiveNamespaces []string) (string, error)

CanonicalizeEXC14N выполняет эксклюзивную каноникализацию XML (EXC-C14N#)

func CanonicalizeWithTransforms

func CanonicalizeWithTransforms(elem *etree.Element, transforms []string) (string, error)

CanonicalizeWithTransforms применяет трансформации перед каноникализацией

func ComputeDigest

func ComputeDigest(data []byte, algorithm string) ([]byte, error)

ComputeDigest вычисляет дайджест данных

func ComputeDigestGOST

func ComputeDigestGOST(data []byte) ([]byte, error)

ComputeDigestGOST вычисляет дайджест ГОСТ Р 34.11-94

func GetSupportedAlgorithms

func GetSupportedAlgorithms() map[string]string

GetSupportedAlgorithms возвращает список поддерживаемых алгоритмов

func IsAlgorithmSupported

func IsAlgorithmSupported(algorithm string) bool

IsAlgorithmSupported проверяет поддержку алгоритма

func SignDataGOST

func SignDataGOST(data []byte, privateKey crypto.PrivateKey) ([]byte, error)

SignDataGOST подписывает данные с использованием алгоритма ГОСТ Р 34.10-2001

func SignDataRSA

func SignDataRSA(data []byte, privateKey *rsa.PrivateKey) ([]byte, error)

SignDataRSA подписывает данные с использованием RSA-PKCS1v15

func SignXMLGIS

func SignXMLGIS(xmlDoc []byte, cert *x509.Certificate, privateKey crypto.PrivateKey) ([]byte, error)

SignXMLGIS подписывает XML документ для ГИС ЖКХ

func VerifyGOST

func VerifyGOST(data, signature []byte, publicKey crypto.PublicKey) error

VerifyGOST проверяет подпись ГОСТ

func VerifyRSA

func VerifyRSA(data, signature []byte, publicKey *rsa.PublicKey) error

VerifyRSA проверяет RSA подпись

Types

type CanonicalizationMethod

type CanonicalizationMethod struct {
	Algorithm string `xml:"Algorithm,attr"`
}

CanonicalizationMethod определяет алгоритм каноникализации

type Cert

type Cert struct {
	CertDigest   CertDigest
	IssuerSerial IssuerSerial
}

Cert содержит данные сертификата

type CertDigest

type CertDigest struct {
	DigestMethod DigestMethod
	DigestValue  string
}

CertDigest содержит дайджест сертификата

type DigestMethod

type DigestMethod struct {
	Algorithm string `xml:"Algorithm,attr"`
}

DigestMethod определяет алгоритм хэширования

type GOSTPrivateKey

type GOSTPrivateKey struct {
}

GOSTPrivateKey представляет приватный ключ ГОСТ (заглушка)

type GOSTPublicKey

type GOSTPublicKey struct {
}

GOSTPublicKey представляет публичный ключ ГОСТ (заглушка)

type IssuerSerial

type IssuerSerial struct {
	X509IssuerName   string
	X509SerialNumber string
}

IssuerSerial содержит информацию об издателе

type KeyInfo

type KeyInfo struct {
	X509Data X509Data
}

KeyInfo содержит информацию о ключе

type Object

type Object struct {
	QualifyingProperties QualifyingProperties
}

Object содержит дополнительные свойства подписи

type QualifyingProperties

type QualifyingProperties struct {
	Target           string `xml:"Target,attr"`
	XMLNS            string `xml:"xmlns:xades,attr"`
	SignedProperties SignedProperties
}

QualifyingProperties содержит свойства XAdES

type Reference

type Reference struct {
	URI          string `xml:"URI,attr"`
	Transforms   Transforms
	DigestMethod DigestMethod
	DigestValue  string
}

Reference содержит ссылку на подписываемые данные

type SOAPBody

type SOAPBody struct {
	XMLName xml.Name `xml:"http://schemas.xmlsoap.org/soap/envelope/ Body"`
	ID      string   `xml:"Id,attr"`
	Content string   `xml:",innerxml"`
}

SOAPBody содержит тело SOAP

type SOAPEnvelope

type SOAPEnvelope struct {
	XMLName xml.Name `xml:"http://schemas.xmlsoap.org/soap/envelope/ Envelope"`
	Header  SOAPHeader
	Body    SOAPBody
}

SOAPEnvelope представляет SOAP конверт

type SOAPHeader

type SOAPHeader struct {
	Security Security `xml:"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd Security"`
}

SOAPHeader содержит заголовок SOAP

type Security

type Security struct {
	XMLName             xml.Name `xml:"http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd Security"`
	Signature           *Signature
	BinarySecurityToken string `xml:"BinarySecurityToken"`
}

Security содержит элемент безопасности

type Signature

type Signature struct {
	XMLName        xml.Name `xml:"http://www.w3.org/2000/09/xmldsig# Signature"`
	ID             string   `xml:"Id,attr"`
	SignedInfo     SignedInfo
	SignatureValue string
	KeyInfo        KeyInfo
	Object         Object `xml:"Object"`
}

Signature представляет XML цифровую подпись для ГИС ЖКХ

type SignatureMethod

type SignatureMethod struct {
	Algorithm string `xml:"Algorithm,attr"`
}

SignatureMethod определяет алгоритм подписи

type SignedInfo

type SignedInfo struct {
	CanonicalizationMethod CanonicalizationMethod
	SignatureMethod        SignatureMethod
	Reference              Reference
}

SignedInfo содержит информацию о подписываемых данных

type SignedProperties

type SignedProperties struct {
	ID                        string `xml:"Id,attr"`
	SignedSignatureProperties SignedSignatureProperties
}

SignedProperties содержит подписанные свойства

type SignedSignatureProperties

type SignedSignatureProperties struct {
	SigningCertificate SigningCertificate
}

SignedSignatureProperties содержит свойства подписи

type SigningCertificate

type SigningCertificate struct {
	Cert Cert
}

SigningCertificate содержит информацию о сертификате

type Transform

type Transform struct {
	Algorithm string `xml:"Algorithm,attr"`
}

Transform определяет преобразование

type Transforms

type Transforms struct {
	Transform []Transform
}

Transforms содержит преобразования данных

type X509Data

type X509Data struct {
	X509Certificate string
}

X509Data содержит данные сертификата

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL