setCustomLoginProvider

Укажите пользовательскую функцию обратного вызова аутентификации клиенту OSLC

    Описание

    пример

    setCustomLoginProvider(myClient,authenticationFunction) указывает пользовательскую функцию обратного вызова аутентификации, authenticationFunction, для объекта клиента OSLC myClient. Можно использовать эту функцию, чтобы аутентифицировать объект клиента OSLC в сетях, которые требуют усовершенствованной аутентификации, которую не поддерживает процесс аутентификации по умолчанию.

    Примечание

    Пользовательская функция обратного вызова аутентификации должна принять эту форму:

    function [success,cookies] = myCustomLoginProvider(server,options)
    % Provide your implementation here
    end
    Пользовательская функция аутентификации должна возвратить два аргумента: состояние успеха и cookie получены от сервера.

    Примеры

    свернуть все

    В этом примере показано, как аутентифицировать клиент OSLC при помощи пользовательской функции аутентификации и пользовательских опций HTTP.

    Создайте клиент OSLC.

    myClient = oslc.Client;

    Установите сервер URL, сервисный корень и путь к каталогу для вашего поставщика услуг.

    setServer(myClient,'http://example.com');
    setServiceRoot(myClient,'rm');
    setCatalogPath(myClient,'oslc/services/catalog');

    Создайте и введите удостоверения пользователя при помощи matlab.net.http.Credentials класс с основным matlab.net.http.AuthenticationScheme объект.

    creds = matlab.net.http.Credentials('Username','jdoe','Password', ...
    'Password1234','scheme',matlab.net.http.AuthenticationScheme.Basic);
    

    Создайте пользовательские опции HTTP при помощи matlab.net.http.HTTPOptions конструктор класса. Установите Credentials свойство и информация о сертификате для пользовательских опций HTTP.

    opts = matlab.net.http.HTTPOptions('Credentials',creds, ...
        'VerifyServerName', false, 'CertificateFilename', '')
    opts = 
    
      HTTPOptions with properties:
    
               MaxRedirects: 20
             ConnectTimeout: 10
                   UseProxy: 1
                   ProxyURI: []
               Authenticate: 1
                Credentials: [1×1 matlab.net.http.Credentials]
         UseProgressMonitor: 0
                SavePayload: 0
            ConvertResponse: 1
             DecodeResponse: 1
         ProgressMonitorFcn: []
        CertificateFilename: ""
           VerifyServerName: 0
                DataTimeout: Inf
            ResponseTimeout: Inf
           KeepAliveTimeout: Inf

    Задайте пользовательские опции HTTP, чтобы аутентифицировать клиент OSLC myClient.

    setHttpOptions(myClient,opts);

    Создайте пользовательскую функцию обратного вызова аутентификации под названием myCustomLoginProvider.

    function [success,cookies] = myCustomLoginProvider(server,options)
    
    end

    Укажите пользовательскую функцию обратного вызова аутентификации с объектом клиента OSLC.

    setCustomLoginProvider(myClient,myCustomLoginProvider);

    Аутентифицируйте объект клиента OSLC.

    login(myClient);

    Входные параметры

    свернуть все

    Клиент OSLC в виде oslc.Client объект.

    Пользовательская функция обратного вызова аутентификации называет в виде вектора символов.

    Пример: 'myCustomLoginProvider'

    Советы

    • Если ваш процесс аутентификации требует определенного набора опций HTTP, вы можете также:

      • Создайте matlab.net.http.HTTPOptions объект и присвоение это вашему клиенту OSLC при помощи setHttpOptions, который передает опции HTTP вашей пользовательской функции обратного вызова аутентификации.

      • Создайте опции HTTP внутренне в вашей пользовательской функции обратного вызова аутентификации.

    • Если вы хотите предварительно сконфигурировать процесс входа в систему с учетными данными или использовать конкретную схему аутентификации, можно создать matlab.net.http.Credentials возразите и включайте его с matlab.net.http.HTTPOptions возразите, что вы присваиваете объекту клиента OSLC. Для получения дополнительной информации смотрите Аутентификацию сервера.

      Примечание

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

    • Можно не указать все коллбэки от объекта клиента OSLC myClient путем ввода:

      setCustomLoginProvider(myClient,'');

    Введенный в R2021b
    Для просмотра документации необходимо авторизоваться на сайте