AutoGRAPH.NET Service Auth — различия между версиями

Материал из TK
Перейти к: навигация, поиск
(WCF (Windows Communication Foundation))
Строка 48: Строка 48:
 
В этом режиме используется особенность библиотеки WCF с помощью behaviours extensions и message inspector's. Пример:
 
В этом режиме используется особенность библиотеки WCF с помощью behaviours extensions и message inspector's. Пример:
   
  +
<pre>var svc = new AutoGRAPHSvcClient();
 
<syntaxhighlight lang="csharp">
 
var svc = new AutoGRAPHSvcClient();
 
 
var bh = new AuthenticateEndpointBehavior();
 
var bh = new AuthenticateEndpointBehavior();
 
svc.Endpoint.Behaviors.Add(bh);
 
svc.Endpoint.Behaviors.Add(bh);
 
bh.Token = svc.Login("demo", "demo");
 
bh.Token = svc.Login("demo", "demo");
  +
var devices = svc.EnumDevices("DemoSchema");
  +
var geofences = svc.EnumGeofences("DemoSchema");</pre>
   
var devices = svc.EnumDevices("DemoSchema");
 
var geofences = svc.EnumGeofences("DemoSchema");
 
</syntaxhighlight>
 
 
и далее все остальные методы не требуют дополнительных изменений для работы. Дополнительный файл с классами Helpers.cs прилагается в архиве.
 
и далее все остальные методы не требуют дополнительных изменений для работы. Дополнительный файл с классами Helpers.cs прилагается в архиве.
   

Версия 21:04, 27 сентября 2015

Режимы с аутентификацией

Если в .config-файле указаны параметры users-directory и devices-directory - работа сервиса немного видоизменяется. Основные отличия приведены ниже.

Отличие в логике работы Без аутентификации С аутентификацией пользователей
Аутентификация Не выполняется

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

Работа всех остальных методов без токена аутентификации невозможна.

Местоположение схем

в каталоге, на который указывает параметр common-directory

схемы общие для всех клиентов, которые выполняют запросы анонимно

в каталоге каждого пользователя (например {users-directory}\username1\Download - далее структуры каталогов должны соответствовать каталогу common-directory - т.е. иметь подкаталоги Schemes, Geofences, Devices, ...).

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

Проверка на доступность приборов клиентам доступны все приборы, которые есть в ключе сервера клиенту доступны только те приборы, которые заданы ему в его собственном каталоге DBF, вобщем те же приборы, которые доступны ему на сервере
Каталог данных общий

общий

Аутентификация

Аутентификация выполняется вызовом метода Login, который возвращает токен. Данный токен должен передаваться в HTTP header всех остальных запросов. Примеры кода, для реализации работы с аутентификацией.

WCF (Windows Communication Foundation)

В этом режиме используется особенность библиотеки WCF с помощью behaviours extensions и message inspector's. Пример:

var svc = new AutoGRAPHSvcClient();
var bh = new AuthenticateEndpointBehavior();
svc.Endpoint.Behaviors.Add(bh);
bh.Token = svc.Login("demo", "demo");
var devices = svc.EnumDevices("DemoSchema");
var geofences = svc.EnumGeofences("DemoSchema");

и далее все остальные методы не требуют дополнительных изменений для работы. Дополнительный файл с классами Helpers.cs прилагается в архиве.

JSON

В этом режиме делается запрос к методу Login для получения токена и устанавливается заголовок AG-TOKEN.

WebClient client = new WebClient();
client.Headers["Content-Type"] = "application/json";
client.Headers["AG-TOKEN"] = client.UploadString("http://localhost:8300/Login", "{\"UserName\":\"demo\",\"Password\":\"demo\"}").Trim('\"', '\"');

// далее обычная работа с JSON

client.DownloadString("http://localhost:8300/EnumSchemas");

и далее все остальные методы не требуют дополнительных изменений для работы.