Профили безопасности

Профиль безопасности ограничивает доступ к внешним ресурсам (файлам, COM-объектам, внешним компонентам, интернет-ресурсам) для кода, выполняемого в безопасном режиме.

Profile

Profile

Профили безопасности и правила доступа к внешним ресурсам.

ACL

Правила доступа профиля безопасности к внешним ресурсам.

Directory

Правила доступа к каталогам файловой системы.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список каталогов, доступ к которым описан в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список каталогов, доступ к которым описан в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("directory"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, alias: str, descr: str | None = None, physicalPath: str | None = None, allowedRead: bool | None = None, allowedWrite: bool | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к каталогу.

Правило состоит из псевдонима и физического пути со своими правами на чтение и запись.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
alias	str	Псевдоним каталога, который используется в коде.	required
descr	str | None	Произвольное описание правила.	None
physicalPath	str | None	Физический путь к каталогу.	None
allowedRead	bool | None	Разрешить чтение из каталога.	None
allowedWrite	bool | None	Разрешить запись в каталог.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    alias: str,
    descr: str | None = None,
    physicalPath: str | None = None,
    allowedRead: bool | None = None,
    allowedWrite: bool | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к каталогу.

    Правило состоит из псевдонима и физического пути со своими правами на чтение и запись.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        alias: Псевдоним каталога, который используется в коде.
        descr: Произвольное описание правила.
        physicalPath: Физический путь к каталогу.
        allowedRead: Разрешить чтение из каталога.
        allowedWrite: Разрешить запись в каталог.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("directory"),
            Arg("update"),
            Arg(alias, "--alias={}"),
            Arg(descr, "--descr={}"),
            Arg(physicalPath, "--physicalPath={}"),
            Arg(b2yn(allowedRead), "--allowedRead={}"),
            Arg(b2yn(allowedWrite), "--allowedWrite={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, alias: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к каталогу.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
alias	str	Псевдоним каталога.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    alias: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к каталогу.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        alias: Псевдоним каталога.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("directory"),
            Arg("remove"),
            Arg(alias, "--alias={}"),
            Arg(access, "--access={}"),
        )
    )

COM

Правила доступа к COM-объектам.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список COM-объектов, доступ к которым описан в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список COM-объектов, доступ к которым описан в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("com"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, com_name: str, descr: str | None = None, file_name: str | None = None, id: str | None = None, host: str | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к COM-объекту.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
com_name	str	Имя COM-объекта.	required
descr	str | None	Произвольное описание правила.	None
file_name	str | None	Имя файла компоненты.	None
id	str | None	Идентификатор COM-объекта.	None
host	str | None	Хост, на котором разрешён COM-объект.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    com_name: str,
    descr: str | None = None,
    file_name: str | None = None,
    id: str | None = None,
    host: str | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к COM-объекту.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        com_name: Имя COM-объекта.
        descr: Произвольное описание правила.
        file_name: Имя файла компоненты.
        id: Идентификатор COM-объекта.
        host: Хост, на котором разрешён COM-объект.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("com"),
            Arg("update"),
            Arg(com_name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(file_name, "--fileName={}"),
            Arg(id, "--id={}"),
            Arg(host, "--host={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, com_name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к COM-объекту.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
com_name	str	Имя COM-объекта.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    com_name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к COM-объекту.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        com_name: Имя COM-объекта.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("com"),
            Arg("remove"),
            Arg(com_name, "--name={}"),
            Arg(access, "--access={}"),
        )
    )

Addin

Правила доступа к внешним компонентам.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список внешних компонент, доступных в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список внешних компонент, доступных в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("addin"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, addin_name: str, descr: str | None = None, hash: str | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к внешней компоненте.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
addin_name	str	Имя внешней компоненты.	required
descr	str | None	Произвольное описание правила.	None
hash	str | None	Хеш файла внешней компоненты для проверки подлинности.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    addin_name: str,
    descr: str | None = None,
    hash: str | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к внешней компоненте.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        addin_name: Имя внешней компоненты.
        descr: Произвольное описание правила.
        hash: Хеш файла внешней компоненты для проверки подлинности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("addin"),
            Arg("update"),
            Arg(addin_name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(hash, "--hash={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, addin_name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к внешней компоненте.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
addin_name	str	Имя внешней компоненты.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    addin_name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к внешней компоненте.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        addin_name: Имя внешней компоненты.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("addin"),
            Arg("remove"),
            Arg(addin_name, "--name={}"),
            Arg(access, "--access={}"),
        )
    )

Module

Правила доступа к модулям.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список модулей, доступ к которым описан в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список модулей, доступ к которым описан в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("module"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, module_name: str, descr: str | None = None, hash: str | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к модулю.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
module_name	str	Имя модуля.	required
descr	str | None	Произвольное описание правила.	None
hash	str | None	Хеш модуля для проверки подлинности.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    module_name: str,
    descr: str | None = None,
    hash: str | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к модулю.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        module_name: Имя модуля.
        descr: Произвольное описание правила.
        hash: Хеш модуля для проверки подлинности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("module"),
            Arg("update"),
            Arg(module_name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(hash, "--hash={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, module_name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к модулю.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
module_name	str	Имя модуля.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    module_name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к модулю.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        module_name: Имя модуля.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("module"),
            Arg("remove"),
            Arg(module_name, "--name={}"),
            Arg(access, "--access={}"),
        )
    )

App

Правила доступа к приложениям.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список приложений, доступ к которым описан в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список приложений, доступ к которым описан в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("app"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, app_name: str, descr: str | None = None, wild: str | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к приложению.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
app_name	str	Имя приложения.	required
descr	str | None	Произвольное описание правила.	None
wild	str | None	Разрешить приложения по маске.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    app_name: str,
    descr: str | None = None,
    wild: str | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к приложению.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        app_name: Имя приложения.
        descr: Произвольное описание правила.
        wild: Разрешить приложения по маске.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("app"),
            Arg("update"),
            Arg(app_name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(wild, "--wild={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, app_name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к приложению.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
app_name	str	Имя приложения.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    app_name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к приложению.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        app_name: Имя приложения.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("app"),
            Arg("remove"),
            Arg(app_name, "--name={}"),
            Arg(access, "--access={}"),
        )
    )

Inet

Правила доступа к интернет-ресурсам.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список интернет-ресурсов, доступных в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список интернет-ресурсов, доступных в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("inet"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, inet_name: str, descr: str | None = None, protocol: str | None = None, url: str | None = None, port: int | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к интернет-ресурсу.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
inet_name	str	Имя интернет-ресурса.	required
descr	str | None	Произвольное описание правила.	None
protocol	str | None	Протокол доступа: http, https, ftp и другие.	None
url	str | None	URL или маска URL ресурса.	None
port	int | None	Порт ресурса.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    inet_name: str,
    descr: str | None = None,
    protocol: str | None = None,
    url: str | None = None,
    port: int | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к интернет-ресурсу.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        inet_name: Имя интернет-ресурса.
        descr: Произвольное описание правила.
        protocol: Протокол доступа: ``http``, ``https``, ``ftp`` и другие.
        url: URL или маска URL ресурса.
        port: Порт ресурса.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("inet"),
            Arg("update"),
            Arg(inet_name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(protocol, "--protocol={}"),
            Arg(url, "--url={}"),
            Arg(port, "--port={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, inet_name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к интернет-ресурсу.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
inet_name	str	Имя интернет-ресурса.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    inet_name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к интернет-ресурсу.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        inet_name: Имя интернет-ресурса.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("inet"),
            Arg("remove"),
            Arg(inet_name, "--name={}"),
            Arg(access, "--access={}"),
        )
    )

list staticmethod

list(session: Session, cluster: str, cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список профилей безопасности кластера.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список профилей безопасности кластера.

    Args:
        cluster: Идентификатор (UUID) кластера.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("list"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, descr: str | None = None, config: bool | None = None, priv: bool | None = None, full_privileged_mode: bool | None = None, privileged_mode_roles: str | None = None, crypto: bool | None = None, right_extension: bool | None = None, right_extension_definition_roles: str | None = None, all_modules_extension: bool | None = None, modules_available_for_extension: str | None = None, modules_not_available_for_extension: str | None = None, cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Создаёт или изменяет профиль безопасности.

Профиль безопасности ограничивает доступ к внешним ресурсам (файлам, COM-объектам, внешним компонентам) для кода, выполняемого в безопасном режиме.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
descr	str | None	Произвольное описание.	None
config	bool | None	Разрешение на доступ к файлам конфигурации: allow или deny.	None
priv	bool | None	Разрешение на привилегированный режим: allow или deny.	None
full_privileged_mode	bool | None	Разрешить полный привилегированный режим.	None
privileged_mode_roles	str | None	Роли, которым разрешён привилегированный режим.	None
crypto	bool | None	Разрешение на работу с криптографией: allow или deny.	None
right_extension	bool | None	Разрешение на расширение прав: allow или deny.	None
right_extension_definition_roles	str | None	Роли, которым разрешено расширение прав.	None
all_modules_extension	bool | None	Разрешить расширение всех модулей.	None
modules_available_for_extension	str | None	Модули, расширение которых разрешено.	None
modules_not_available_for_extension	str | None	Модули, расширение которых запрещено.	None
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    descr: str | None = None,
    config: bool | None = None,
    priv: bool | None = None,
    full_privileged_mode: bool | None = None,
    privileged_mode_roles: str | None = None,
    crypto: bool | None = None,
    right_extension: bool | None = None,
    right_extension_definition_roles: str | None = None,
    all_modules_extension: bool | None = None,
    modules_available_for_extension: str | None = None,
    modules_not_available_for_extension: str | None = None,
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Создаёт или изменяет профиль безопасности.

    Профиль безопасности ограничивает доступ к внешним ресурсам (файлам, COM-объектам, внешним компонентам) для кода, выполняемого в безопасном режиме.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        descr: Произвольное описание.
        config: Разрешение на доступ к файлам конфигурации: ``allow`` или ``deny``.
        priv: Разрешение на привилегированный режим: ``allow`` или ``deny``.
        full_privileged_mode: Разрешить полный привилегированный режим.
        privileged_mode_roles: Роли, которым разрешён привилегированный режим.
        crypto: Разрешение на работу с криптографией: ``allow`` или ``deny``.
        right_extension: Разрешение на расширение прав: ``allow`` или ``deny``.
        right_extension_definition_roles: Роли, которым разрешено расширение прав.
        all_modules_extension: Разрешить расширение всех модулей.
        modules_available_for_extension: Модули, расширение которых разрешено.
        modules_not_available_for_extension: Модули, расширение которых запрещено.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("update"),
            Arg(name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(b2yn(config), "--config={}"),
            Arg(b2yn(priv), "--priv={}"),
            Arg(b2yn(full_privileged_mode), "--full-privileged-mode={}"),
            Arg(privileged_mode_roles, "--privileged-mode-roles={}"),
            Arg(b2yn(crypto), "--crypto={}"),
            Arg(b2yn(right_extension), "--right-extension={}"),
            Arg(
                right_extension_definition_roles,
                "--right-extension-definition-roles={}",
            ),
            Arg(b2yn(all_modules_extension), "--all-modules-extension={}"),
            Arg(
                modules_available_for_extension,
                "--modules-available-for-extension={}",
            ),
            Arg(
                modules_not_available_for_extension,
                "--modules-not-available-for-extension={}",
            ),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет профиль безопасности.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет профиль безопасности.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("remove"),
            Arg(name, "--name={}"),
        )
    )

Profile.ACL.Directory

Directory

Правила доступа к каталогам файловой системы.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список каталогов, доступ к которым описан в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список каталогов, доступ к которым описан в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("directory"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, alias: str, descr: str | None = None, physicalPath: str | None = None, allowedRead: bool | None = None, allowedWrite: bool | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к каталогу.

Правило состоит из псевдонима и физического пути со своими правами на чтение и запись.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
alias	str	Псевдоним каталога, который используется в коде.	required
descr	str | None	Произвольное описание правила.	None
physicalPath	str | None	Физический путь к каталогу.	None
allowedRead	bool | None	Разрешить чтение из каталога.	None
allowedWrite	bool | None	Разрешить запись в каталог.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    alias: str,
    descr: str | None = None,
    physicalPath: str | None = None,
    allowedRead: bool | None = None,
    allowedWrite: bool | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к каталогу.

    Правило состоит из псевдонима и физического пути со своими правами на чтение и запись.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        alias: Псевдоним каталога, который используется в коде.
        descr: Произвольное описание правила.
        physicalPath: Физический путь к каталогу.
        allowedRead: Разрешить чтение из каталога.
        allowedWrite: Разрешить запись в каталог.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("directory"),
            Arg("update"),
            Arg(alias, "--alias={}"),
            Arg(descr, "--descr={}"),
            Arg(physicalPath, "--physicalPath={}"),
            Arg(b2yn(allowedRead), "--allowedRead={}"),
            Arg(b2yn(allowedWrite), "--allowedWrite={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, alias: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к каталогу.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
alias	str	Псевдоним каталога.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    alias: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к каталогу.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        alias: Псевдоним каталога.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("directory"),
            Arg("remove"),
            Arg(alias, "--alias={}"),
            Arg(access, "--access={}"),
        )
    )

Profile.ACL.COM

COM

Правила доступа к COM-объектам.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список COM-объектов, доступ к которым описан в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список COM-объектов, доступ к которым описан в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("com"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, com_name: str, descr: str | None = None, file_name: str | None = None, id: str | None = None, host: str | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к COM-объекту.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
com_name	str	Имя COM-объекта.	required
descr	str | None	Произвольное описание правила.	None
file_name	str | None	Имя файла компоненты.	None
id	str | None	Идентификатор COM-объекта.	None
host	str | None	Хост, на котором разрешён COM-объект.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    com_name: str,
    descr: str | None = None,
    file_name: str | None = None,
    id: str | None = None,
    host: str | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к COM-объекту.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        com_name: Имя COM-объекта.
        descr: Произвольное описание правила.
        file_name: Имя файла компоненты.
        id: Идентификатор COM-объекта.
        host: Хост, на котором разрешён COM-объект.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("com"),
            Arg("update"),
            Arg(com_name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(file_name, "--fileName={}"),
            Arg(id, "--id={}"),
            Arg(host, "--host={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, com_name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к COM-объекту.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
com_name	str	Имя COM-объекта.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    com_name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к COM-объекту.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        com_name: Имя COM-объекта.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("com"),
            Arg("remove"),
            Arg(com_name, "--name={}"),
            Arg(access, "--access={}"),
        )
    )

Profile.ACL.Addin

Addin

Правила доступа к внешним компонентам.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список внешних компонент, доступных в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список внешних компонент, доступных в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("addin"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, addin_name: str, descr: str | None = None, hash: str | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к внешней компоненте.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
addin_name	str	Имя внешней компоненты.	required
descr	str | None	Произвольное описание правила.	None
hash	str | None	Хеш файла внешней компоненты для проверки подлинности.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    addin_name: str,
    descr: str | None = None,
    hash: str | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к внешней компоненте.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        addin_name: Имя внешней компоненты.
        descr: Произвольное описание правила.
        hash: Хеш файла внешней компоненты для проверки подлинности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("addin"),
            Arg("update"),
            Arg(addin_name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(hash, "--hash={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, addin_name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к внешней компоненте.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
addin_name	str	Имя внешней компоненты.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    addin_name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к внешней компоненте.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        addin_name: Имя внешней компоненты.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("addin"),
            Arg("remove"),
            Arg(addin_name, "--name={}"),
            Arg(access, "--access={}"),
        )
    )

Profile.ACL.Module

Module

Правила доступа к модулям.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список модулей, доступ к которым описан в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список модулей, доступ к которым описан в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("module"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, module_name: str, descr: str | None = None, hash: str | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к модулю.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
module_name	str	Имя модуля.	required
descr	str | None	Произвольное описание правила.	None
hash	str | None	Хеш модуля для проверки подлинности.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    module_name: str,
    descr: str | None = None,
    hash: str | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к модулю.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        module_name: Имя модуля.
        descr: Произвольное описание правила.
        hash: Хеш модуля для проверки подлинности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("module"),
            Arg("update"),
            Arg(module_name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(hash, "--hash={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, module_name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к модулю.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
module_name	str	Имя модуля.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    module_name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к модулю.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        module_name: Имя модуля.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("module"),
            Arg("remove"),
            Arg(module_name, "--name={}"),
            Arg(access, "--access={}"),
        )
    )

Profile.ACL.App

App

Правила доступа к приложениям.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список приложений, доступ к которым описан в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список приложений, доступ к которым описан в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("app"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, app_name: str, descr: str | None = None, wild: str | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к приложению.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
app_name	str	Имя приложения.	required
descr	str | None	Произвольное описание правила.	None
wild	str | None	Разрешить приложения по маске.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    app_name: str,
    descr: str | None = None,
    wild: str | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к приложению.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        app_name: Имя приложения.
        descr: Произвольное описание правила.
        wild: Разрешить приложения по маске.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("app"),
            Arg("update"),
            Arg(app_name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(wild, "--wild={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, app_name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к приложению.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
app_name	str	Имя приложения.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    app_name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к приложению.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        app_name: Имя приложения.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("app"),
            Arg("remove"),
            Arg(app_name, "--name={}"),
            Arg(access, "--access={}"),
        )
    )

Profile.ACL.Inet

Inet

Правила доступа к интернет-ресурсам.

list staticmethod

list(session: Session, cluster: str, name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> list[RacRecord]

Возвращает список интернет-ресурсов, доступных в профиле.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
list[RacRecord]	list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def list(
    session: Session,
    cluster: str,
    name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> list[RacRecord]:
    """Возвращает список интернет-ресурсов, доступных в профиле.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        list[dict[str, str | int]]: записи RAC. Пустой список, если RAC ничего не вернул.

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.exec(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("inet"),
            Arg("list"),
            Arg(access, "--access={}"),
        )
    ).to_list()

update staticmethod

update(session: Session, cluster: str, name: str, inet_name: str, descr: str | None = None, protocol: str | None = None, url: str | None = None, port: int | None = None, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Добавляет или изменяет правило доступа к интернет-ресурсу.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
inet_name	str	Имя интернет-ресурса.	required
descr	str | None	Произвольное описание правила.	None
protocol	str | None	Протокол доступа: http, https, ftp и другие.	None
url	str | None	URL или маска URL ресурса.	None
port	int | None	Порт ресурса.	None
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def update(
    session: Session,
    cluster: str,
    name: str,
    inet_name: str,
    descr: str | None = None,
    protocol: str | None = None,
    url: str | None = None,
    port: int | None = None,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Добавляет или изменяет правило доступа к интернет-ресурсу.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        inet_name: Имя интернет-ресурса.
        descr: Произвольное описание правила.
        protocol: Протокол доступа: ``http``, ``https``, ``ftp`` и другие.
        url: URL или маска URL ресурса.
        port: Порт ресурса.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("inet"),
            Arg("update"),
            Arg(inet_name, "--name={}"),
            Arg(descr, "--descr={}"),
            Arg(protocol, "--protocol={}"),
            Arg(url, "--url={}"),
            Arg(port, "--port={}"),
            Arg(access, "--access={}"),
        )
    )

remove staticmethod

remove(session: Session, cluster: str, name: str, inet_name: str, access: str = 'list', cluster_user: str | None = None, cluster_pwd: str | None = None) -> None

Удаляет правило доступа к интернет-ресурсу.

Parameters:

Name	Type	Description	Default
cluster	str	Идентификатор (UUID) кластера.	required
name	str	Имя профиля безопасности.	required
inet_name	str	Имя интернет-ресурса.	required
access	str	Вид доступа: read или write.	'list'
cluster_user	str | None	Имя администратора кластера.	None
cluster_pwd	str | None	Пароль администратора кластера.	None

Returns:

Type	Description
None	None

:raises raclib.errors.RACNotFoundError: файл rac не найден или не может быть запущен. :raises raclib.errors.RACTimeoutError: RAC не ответил за timeout секунд, заданный в сессии. :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий raclib.errors.

Source code in src/raclib/cmd/profile.py

@staticmethod
def remove(
    session: Session,
    cluster: str,
    name: str,
    inet_name: str,
    access: str = "list",
    cluster_user: str | None = None,
    cluster_pwd: str | None = None,
) -> None:
    """Удаляет правило доступа к интернет-ресурсу.

    Args:
        cluster: Идентификатор (UUID) кластера.
        name: Имя профиля безопасности.
        inet_name: Имя интернет-ресурса.
        access: Вид доступа: ``read`` или ``write``.
        cluster_user: Имя администратора кластера.
        cluster_pwd: Пароль администратора кластера.

    Returns:
        None

    :raises raclib.errors.RACNotFoundError: файл ``rac`` не найден или не может быть запущен.
    :raises raclib.errors.RACTimeoutError: RAC не ответил за ``timeout`` секунд, заданный в сессии.
    :raises raclib.errors.UnknownError: RAC вернул ошибку, которой нет в таблице соответствий ``raclib.errors``.
    """
    return session.call(
        Command(
            Arg("profile"),
            Arg(cluster, "--cluster={}"),
            Arg(cluster_user, "--cluster-user={}"),
            Arg(cluster_pwd, "--cluster-pwd={}"),
            Arg("acl"),
            Arg(name, "--name={}"),
            Arg("inet"),
            Arg("remove"),
            Arg(inet_name, "--name={}"),
            Arg(access, "--access={}"),
        )
    )