Basic authentication

Основная аутентификация (Basic Authentication) — это один из простейших и самых распространённых методов аутентификации в веб-приложениях, который передаёт имя пользователя и пароль в заголовке HTTP-запроса. Этот метод часто используется в тестировании веб-приложений для проверки защищённых ресурсов. В WebDriverIO взаимодействие с базовой аутентификацией можно настроить различными способами, и ниже приведён подробный обзор того, как это можно сделать.

1. Взаимодействие с Basic Authentication через URL

Для тестирования страниц с Basic Authentication можно использовать способ, при котором логин и пароль передаются прямо в URL-адресе. Это может быть удобным решением, если аутентификация необходима для доступа к определённой странице, и нужно минимизировать вмешательство в код.

Пример URL с базовой аутентификацией:

http://username:password@your-website.com

WebDriverIO поддерживает такой формат URL. Когда в тестах требуется обратиться к защищённому ресурсу, достаточно просто указать логин и пароль в URL-адресе, как показано выше.

Пример кода:

describe('Basic Authentication Test', () => {
    it('should access the page with basic authentication', async () => {
        await browser.url('http://username:password@your-website.com');
        const pageTitle = await browser.getTitle();
        assert.strictEqual(pageTitle, 'Expected Page Title');
    });
});

Этот метод является простым, но его использование ограничено. Он не всегда работает в случаях, когда требуется больше контроля над аутентификацией, например, когда веб-страница требует динамической аутентификации или когда используются более сложные механизмы защиты.

2. Использование ChromeOptions для аутентификации

Другим методом является использование параметров конфигурации браузера. WebDriverIO позволяет передавать параметры запуска браузера, что может быть полезно для настройки Basic Authentication.

Для браузера Chrome можно использовать опцию --auth-server-whitelist и --auth-negotiate-delegate-whitelist для работы с аутентификацией на уровне браузера.

Пример конфигурации с использованием ChromeOptions:

exports.config = {
    capabilities: [{
        browserName: 'chrome',
        'goog:chromeOptions': {
            args: [
                '--headless',
                '--disable-gpu',
                '--auth-server-whitelist=your-website.com',
                '--auth-negotiate-delegate-whitelist=your-website.com'
            ]
        }
    }]
};

Когда необходимо тестировать страницу, защищённую базовой аутентификацией, через Chrome, можно указать соответствующие параметры. Эти опции могут обеспечить правильную работу аутентификации, даже если она требует специфичных настроек для разных доменов.

3. Использование прокси-сервера для Basic Authentication

Иногда в тестах необходимо тестировать аутентификацию через прокси-сервер, который будет перехватывать запросы и передавать логин и пароль. Это может быть полезно, когда тесты включают большое количество защищённых ресурсов, и нужно централизованно управлять аутентификацией.

Для настройки прокси-сервера можно использовать дополнительные библиотеки или настройки WebDriverIO, которые позволяют установить прокси-сервер и передавать данные аутентификации через заголовки.

Пример использования прокси-сервера с аутентификацией:

exports.config = {
    services: ['selenium-standalone'],
    capabilities: [{
        browserName: 'chrome',
        proxy: {
            proxyType: 'manual',
            httpProxy: 'http://proxy-server.com:8080',
            sslProxy: 'http://proxy-server.com:8080',
            noProxy: 'localhost, 127.0.0.1'
        },
        'goog:chromeOptions': {
            args: ['--headless']
        }
    }]
};

Здесь указаны параметры для работы с прокси-сервером. Если сервер требует аутентификацию, то параметры логина и пароля могут быть переданы через заголовки запросов.

4. Вручную встраиваемая аутентификация

Если необходимо настроить аутентификацию на уровне теста и получить больше контроля, можно воспользоваться методами для программного добавления заголовков HTTP, включая авторизационные данные. В таком случае тестовый код может встраивать аутентификационные данные в заголовки запросов или использовать сессионные куки.

Пример реализации Basic Authentication через куки:

describe('Basic Authentication Test', () => {
    it('should log in via cookies', async () => {
        await browser.url('http://your-website.com');
        await browser.setCookies([{
            name: 'auth',
            value: 'Basic ' + Buffer.from('username:password').toString('base64'),
            domain: 'your-website.com'
        }]);
        const pageTitle = await browser.getTitle();
        assert.strictEqual(pageTitle, 'Expected Page Title');
    });
});

В этом примере создаётся куки с базовой аутентификацией, которые будут отправлены в каждом запросе на веб-сайт. Это может быть полезно в случаях, когда аутентификация должна быть выполнена один раз в начале теста, а затем используется для всех последующих запросов.

5. Взаимодействие с сервером через API для аутентификации

Иногда может возникнуть необходимость проверить Basic Authentication на сервере через API-запросы, а не через сам браузер. В этом случае для взаимодействия с сервером можно использовать такие инструменты, как Axios или Fetch, чтобы отправлять запросы с базовой аутентификацией.

Пример API-запроса с Basic Authentication:

const axios = require('axios');

describe('API Basic Authentication Test', () => {
    it('should authenticate via API', async () => {
        const response = await axios.get('http://your-website.com/protected-resource', {
            auth: {
                username: 'username',
                password: 'password'
            }
        });
        assert.strictEqual(response.status, 200);
    });
});

Этот способ подходит для тестирования взаимодействий с сервером, где аутентификация происходит через HTTP-заголовки, но не обязательно через интерфейс пользователя.

Заключение

Использование Basic Authentication в WebDriverIO может быть реализовано несколькими способами, в зависимости от требований теста и конфигурации среды. Важно учитывать, что данный метод аутентификации не является самым безопасным и используется преимущественно для тестирования и разработки, когда требуется быстро и просто настроить доступ к защищённым ресурсам.

Оглавление