Class isp dns::Connection

Материал из ISPWiki
Перейти к: навигация, поиск

Работа с DNS

Класс isp_dns::Connection

Данный класс является абстрактным

Представление подключения к DNS-серверу

#include <ispdns.h> 

Описание:

class isp_dns::Connection

Предоставляет методы для работы с подключением к DNS-серверу, при этом также является контейнером для горизонтов видимости DNS (view)

Warning: Windows DNS Server не поддерживает реализацию горизонтов видимости (view), поэтому используется только один view, который может быть получен функцией GetDefaultView.

Содержание

Открытые члены (кратко)

virtual string Name () const =0

Возвращает имя текущего view.


virtual string DestinationIP () const =0

Возвращает список IP-адресов, с которыми связан данный view. Список IP-адресов представяется строкой, разделителем является " " (пробел).


string MasterIP () const

Возвращает адрес, который будет использован как master ip на ведомых серверах имен


virtual string AllowTransfer () const =0

Возвращает список IP-адресов, на которые разрешена передача зон данного view. Список IP-адресов представяется строкой, разделителем является " " (пробел)


virtual void SetDestinationIP ( const string &destip )

Устанавливает список IP-адресов, с которыми связан данный view. Список IP-адресов представяется строкой, разделителем является " " (пробел).


virtual void SetAllowTransfer ( const string &allowtransfer )

Устанавливает список IP-адресов, на которые разрешена передача зон данного view. Список IP-адресов представяется строкой, разделителем является " " (пробел)


virtual void Enable ()=0

Разрешает ответы DNS сервера по запросам для данного view.


virtual void Disable ()=0

Запрещает ответы DNS сервера по запросам для данного view.


virtual ViewPtr CreateView ( const string &view , const string &destip )

Создает view с переданным именем и списком IP-адресов. Список IP-адресов представяется строкой, разделителем является " " (пробел). Возвращает view.


virtual void Delete ()=0

удаляет текущий view.


virtual ViewPtr GetView ()=0

Возвращает текущий view.


virtual ViewPtr GetDefaultView ()=0

Возвращает view по умолчанию


ViewPtr GetView ( const string &view )

Возвращает текущий view (аналогично Assert(view)...GetView())


virtual void Reconfig () const =0

Выполняет обновление данных о зонах (перечитывает информацию из настроек конкретной реализации DNS)


virtual const StringSet & SupportedDnssecAlgorithms () const =0

Возвращает список с номерами поддерживаемых dns-сервером алгоритмов шифрования DNSSEC.


const StringSet & AllDnssecAlgorithms () const

Возвращает список с номерами алгоритмов шифрования DNSSEC. Domain Name System Security (DNSSEC) Algorithm Numbers


const StringSet & AllDsDigestAlgorithms () const

Возвращает список с номерами алгоритмов хеширования используемых в DS записях. Delegation Signer (DS) Resource Record (RR) Type Digest Algorithms


virtual DnssecParam GetDnssecParam ()=0

Получение используемых параметров алгоритмов шифрования DNSSEC.


virtual void ValidatorDnssecParam ( DnssecParam &dnssec_param )

Валидация параметров алгоритмов шифрования DNSSEC, неправильные значения устанавливаются на значения по умолчанию


virtual void EnableDnssec ( const DnssecParam &dnssec_param )

Включает использование DNSSEC.


virtual void DisableDnssec () const =0

Выключает использование DNSSEC.


bool CheckGostAlgorithms () const

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


virtual  ~Connection ()

Деструктор

Методы навигации по списку view

Данные методы обеспечивают навигацию по списку view

Warning: Связь между функциями обхода списка view (First, Next, Eof) и перехода к view (Assert, Find) не гарантируется Это значит, например, что вызов Next после Find не гарантирует, что текущий view будет следующим после найденного

virtual bool First ()=0

Осуществляет переход к первому view. Возвращает true в случае успеха, false в противном случае


virtual bool Next ()=0

Осуществляет переход к следующему view. Возвращает true в случае успеха, false в противном случае


virtual bool Eof ()=0

Возвращает true, если достигнут конец списка view.


void Assert ( const string &view )

Осуществляет переход к view с указанным именем. Если view не найден, генерирует исключение


virtual bool Find ( const string &view )

Осуществляет переход к view с указанным именем. Если view найден, возвращает true.

Защищённые члены (кратко)

Приватные члены (кратко)

Конструкторы

virtual ~Connection ()

Деструктор

Методы

virtual bool First ()=0

Осуществляет переход к первому view. Возвращает true в случае успеха, false в противном случае

virtual bool Next ()=0

Осуществляет переход к следующему view. Возвращает true в случае успеха, false в противном случае

virtual bool Eof ()=0

Возвращает true, если достигнут конец списка view.

void Assert ( const string &view )

Осуществляет переход к view с указанным именем. Если view не найден, генерирует исключение

virtual bool Find ( const string &view )

Осуществляет переход к view с указанным именем. Если view найден, возвращает true.

virtual string Name () const =0

Возвращает имя текущего view.

virtual string DestinationIP () const =0

Возвращает список IP-адресов, с которыми связан данный view. Список IP-адресов представяется строкой, разделителем является " " (пробел).

Связанный IP-адрес обозначает адрес прослушиваемого DNS-сервером сетевого интерфейса, входящий в данный горизонт видимости. DNS-запросы, принятые с этого адреса, будут получать ответ от данного view. Запросы, принятые с интерфейсов с другими адресами ответ от данного view не получат

string MasterIP () const

Возвращает адрес, который будет использован как master ip на ведомых серверах имен

Возвращает первый адрес из списка DestinationIP или значение параметра DnsNsMasterIp, если таковой был задан в кофигурационном файле

virtual string AllowTransfer () const =0

Возвращает список IP-адресов, на которые разрешена передача зон данного view. Список IP-адресов представяется строкой, разделителем является " " (пробел)

virtual void SetDestinationIP ( const string &destip )

Устанавливает список IP-адресов, с которыми связан данный view. Список IP-адресов представяется строкой, разделителем является " " (пробел).

Связанный IP-адрес обозначает адрес прослушиваемого DNS-сервером сетевого интерфейса, входящий в данный горизонт видимости. DNS-запросы, принятые с этого адреса, будут получать ответ от данного view. Запросы, принятые с интерфейсов с другими адресами ответ от данного view не получат

virtual void SetAllowTransfer ( const string &allowtransfer )

Устанавливает список IP-адресов, на которые разрешена передача зон данного view. Список IP-адресов представяется строкой, разделителем является " " (пробел)

virtual void Enable ()=0

Разрешает ответы DNS сервера по запросам для данного view.

virtual void Disable ()=0

Запрещает ответы DNS сервера по запросам для данного view.

virtual ViewPtr CreateView ( const string &view , const string &destip )

Создает view с переданным именем и списком IP-адресов. Список IP-адресов представяется строкой, разделителем является " " (пробел). Возвращает view.

virtual void Delete ()=0

удаляет текущий view.

virtual ViewPtr GetView ()=0

Возвращает текущий view.

virtual ViewPtr GetDefaultView ()=0

Возвращает view по умолчанию

ViewPtr GetView ( const string &view )

Возвращает текущий view (аналогично Assert(view)...GetView())

virtual void Reconfig () const =0

Выполняет обновление данных о зонах (перечитывает информацию из настроек конкретной реализации DNS)

virtual const StringSet &SupportedDnssecAlgorithms () const =0

Возвращает список с номерами поддерживаемых dns-сервером алгоритмов шифрования DNSSEC.

const StringSet &AllDnssecAlgorithms () const

Возвращает список с номерами алгоритмов шифрования DNSSEC. Domain Name System Security (DNSSEC) Algorithm Numbers

const StringSet &AllDsDigestAlgorithms () const

Возвращает список с номерами алгоритмов хеширования используемых в DS записях. Delegation Signer (DS) Resource Record (RR) Type Digest Algorithms

virtual DnssecParam GetDnssecParam ()=0

Получение используемых параметров алгоритмов шифрования DNSSEC.

virtual void ValidatorDnssecParam ( DnssecParam &dnssec_param )

Валидация параметров алгоритмов шифрования DNSSEC, неправильные значения устанавливаются на значения по умолчанию

virtual void EnableDnssec ( const DnssecParam &dnssec_param )

Включает использование DNSSEC.

virtual void DisableDnssec () const =0

Выключает использование DNSSEC.

bool CheckGostAlgorithms () const

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