Пакет bsign-aliens

Начиная с обновлений БЮЛЛЕТЕНЬ № 2023-0426SE17 (оперативное обновление 1.7.4) и БЮЛЛЕТЕНЬ № 2023-0727SE47 (оперативное обновление 4.7.4) в составе базового репозитория доступен пакет bsign-aliens. В Astra Linux Special Edirion 1.8 этот пакет доступен в составе расширенного основного репозитория.

Пакет bsign-aliens предоставляет инструменты командной строки:

• bsign-

• dll — инструмент для подписывания файлов .dll (формат PE). Доступен как отдельный инструмент только в Astra Linux Specail Edition 1.7. В Astra Linux Specail Edition 1.8 функционал подписания файлов формата PE интегрирован в инструмент bsign-integrator.
• bsign-dot-net

• — инструмент для подписывания файлов .

• net

• .

Для обновлений, в которых пакет bsign-aliens недоступен, далее предлагается сценарий автоматизации подписания.

Установка пакета:

Инструмент bsign-dll

Синтаксис команды для подписания dll файлов:

Параметры команды:

• -h, --help — показать подсказку по командам;
• -p <параметры>, --pgoptions <параметры> — передать следующие параметры программе bsign;
• -R, --replace — заменить оригинальный DLL не изменяя его имя;
• -w, --show-info — показать информацию о подписи;
• -h - вывод краткой подсказки

Инструмент bsign-dot-net

Синтаксис команды для подписания dot-net файлов:

Параметры команды bsign-dot-net:

• -h, --help — показать подсказку по командам;
• -p, --pgoptions — передать следующие параметры программе bsign.

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

Сценарий предназначен для использования в обновлениях Astra Linux, в которых недоступен пакет bsign-aliens.
Сценарий может также применяться к файлам формата elf (исполняемые файлы и библиотеки Astra Linux). Для подписания таких файлов следует использовать опцию -R сценария.

Сценарий применим в обновлениях Astra Linux, не включающих в свой состав пакет bsigh-aliens (обновления, выпущенных до оперативных обновлений 1.7.4/4.7.4). Для применения сценария:

1. Подключить репозитории:
   • в Astra Linux Special Edition 1.8 — расширенный репозиторий;
   • в Astra Linux Special Edition x.7 — базовый репозиторий;
   • в более ранних обновлениях Astra Linux Special Edition — репозиторий со средствами разработки.

2. Установить набор пакетов и библиотек. Команда для установки пакетов:

   Command
   sudo apt install python3 python3-pip python3-dev python-dev build-essential libssl-dev libxml2-dev libffi-dev libxslt1-dev zlib1g-dev python3-xattr python3-pyelftools

   
   

3. Для обновлений Astra Linux Special Edition более ранних чем обновление x.7  установить библиотеку python cffi:
   

   Command
   sudo apt install python3-cffi

   
   

4. Перед выполнением подписания импортировать секретный ключ (предполагается, что он уже получен):
   

   Command
   gpg --import --pinentry-mode=loopback --passphrase-file=org_password.txt org_secret.gpg

   
   

Исходный код сценария

#!/usr/bin/python3
import sys
import shutil
import subprocess
import argparse
import xattr
import tempfile

DIGSIG_ELF_SIG_SIZE = 512

parser = argparse.ArgumentParser()
parser.add_argument('dll', metavar='filename.dll', help='path to dll to sign')
parser.add_argument('-p', '--pgoptions', help='pass options to the privacy guard program')
parser.add_argument('-R', '--replace', help='replace original file', action='store_true')
parser.add_argument('-w', '--show-info', help='describe signature information', action='store_true')
args = parser.parse_args()

name = args.dll

def show_info():
    f = tempfile.NamedTemporaryFile()
    shutil.copyfile(args.dll, f.name)
    f.seek(-DIGSIG_ELF_SIG_SIZE, 2)
    sig = f.read(DIGSIG_ELF_SIG_SIZE)
    f.seek(-DIGSIG_ELF_SIG_SIZE, 2)
    f.write(b'\x00' * DIGSIG_ELF_SIG_SIZE)
    f.flush()
    xattr.setxattr(f.name, 'user.sig', sig)
    bsign_args = ['bsign', '-w', f.name]
    bsign = subprocess.run(bsign_args, stdout=subprocess.PIPE)
    print(bsign.stdout.decode()
        .replace("xattr ", "dll ")
        .replace(f.name, args.dll))
    return bsign.returncode

try:
    if args.show_info:
        sys.exit(show_info())

    if args.replace:
        new_name = name
    else:
        if not name.endswith(('.dll', '.exe')):
            print("[Error] Must have filename.dll as an argument")
            sys.exit(1)
        new_name = name[:-4] + '_signed' + name[-4:]
        shutil.copyfile(name, new_name)

    with open(new_name, mode='ab') as f:
        f.write(b'\x00' * DIGSIG_ELF_SIG_SIZE)

    bsign_args = ['bsign', '--sign', '--xattr', new_name]
    if args.pgoptions is not None:
        if '--batch' in args.pgoptions:
            bsign_args.append('--nopass')
        bsign_args.extend(['-p', args.pgoptions])

    if subprocess.call(bsign_args):
        print("[Error] Calling bsign failure")
        sys.exit(1)

    sig = xattr.getxattr(new_name, 'user.sig')
    xattr.removexattr(new_name, 'user.sig')

    with open(new_name, mode='r+b') as f:
        f.seek(-DIGSIG_ELF_SIG_SIZE, 2)
        f.write(sig)

except Exception as e:
    print(str(e))
    sys.exit(1)

Синтаксис вызова сценария

Параметры вызова сценария:

• -p, — pgoptions передать следующие параметры программе bsign;
• -R — replace - заменить оригинальный DLL не изменяя его имя. Позволяет также подписывать файлы формата elf;
• -w — проверка подписи;
• -h — вывод краткой подсказки.

Примеры вызова сценария

Для подписания одного файла

Пример вызова для подписания файла test.dll (предполагается, что сценарий и подписываемый файл находятся в одном каталоге):

После вызова сценария ввести пароль из файла org_password.txt.

При успешном подписывании в  текущем каталоге будет создан файл test_signed.dll.

Для подписания пакета файлов

Получить шестнадцатеричный идентификатор ключа командой:

Подписание всех файлов в текущем каталоге:

где default-key - шестнадцатеричный идентификатор ключа. В данном примере использован ключ -R, который позволяет встроить подпись в подписываемый файл не создавая его копию.

Для проверки подписи файла

Пример проверки подписи файла test.dll: