Методы обнаружения OpenID — Yadis VS HTML
-
16-09-2020 - |
Вопрос
Недавно я начал писать свой собственный потребительский класс PHP OpenID, чтобы лучше понять openID.В качестве руководства я ссылаюсь на [Класс LightOpenID][1].По большей части я понимаю код и то, как работает OpenID.Мое замешательство приходит, когда я смотрю на автора. discover
функция:
function discover($url)
{
if(!$url) throw new ErrorException('No identity supplied.');
# We save the original url in case of Yadis discovery failure.
# It can happen when we'll be lead to an XRDS document
# which does not have any OpenID2 services.
$originalUrl = $url;
# A flag to disable yadis discovery in case of failure in headers.
$yadis = true;
# We'll jump a maximum of 5 times, to avoid endless redirections.
for($i = 0; $i < 5; $i ++) {
if($yadis) {
$headers = explode("\n",$this->request($url, 'HEAD'));
$next = false;
foreach($headers as $header) {
if(preg_match('#X-XRDS-Location\s*:\s*(.*)#', $header, $m)) {
$url = $this->build_url(parse_url($url), parse_url(trim($m[1])));
$next = true;
}
if(preg_match('#Content-Type\s*:\s*application/xrds\+xml#i', $header)) {
# Found an XRDS document, now let's find the server, and optionally delegate.
$content = $this->request($url, 'GET');
# OpenID 2
# We ignore it for MyOpenID, as it breaks sreg if using OpenID 2.0
$ns = preg_quote('http://specs.openid.net/auth/2.0/');
if (preg_match('#<Service.*?>(.*)<Type>\s*'.$ns.'(.*?)\s*</Type>(.*)</Service>#s', $content, $m)
&& !preg_match('/myopenid\.com/i', $this->identity)) {
$content = $m[1] . $m[3];
if($m[2] == 'server') $this->identifier_select = true;
$content = preg_match('#<URI>(.*)</URI>#', $content, $server);
$content = preg_match('#<LocalID>(.*)</LocalID>#', $content, $delegate);
if(empty($server)) {
return false;
}
# Does the server advertise support for either AX or SREG?
$this->ax = preg_match('#<Type>http://openid.net/srv/ax/1.0</Type>#', $content);
$this->sreg = preg_match('#<Type>http://openid.net/sreg/1.0</Type>#', $content);
$server = $server[1];
if(isset($delegate[1])) $this->identity = $delegate[1];
$this->version = 2;
$this->server = $server;
return $server;
}
# OpenID 1.1
$ns = preg_quote('http://openid.net/signon/1.1');
if(preg_match('#<Service.*?>(.*)<Type>\s*'.$ns.'\s*</Type>(.*)</Service>#s', $content, $m)) {
$content = $m[1] . $m[2];
$content = preg_match('#<URI>(.*)</URI>#', $content, $server);
$content = preg_match('#<.*?Delegate>(.*)</.*?Delegate>#', $content, $delegate);
if(empty($server)) {
return false;
}
# AX can be used only with OpenID 2.0, so checking only SREG
$this->sreg = preg_match('#<Type>http://openid.net/sreg/1.0</Type>#', $content);
$server = $server[1];
if(isset($delegate[1])) $this->identity = $delegate[1];
$this->version = 1;
$this->server = $server;
return $server;
}
$next = true;
$yadis = false;
$url = $originalUrl;
$content = null;
break;
}
}
if($next) continue;
# There are no relevant information in headers, so we search the body.
$content = $this->request($url, 'GET');
if($location = $this->htmlTag($content, 'meta', 'http-equiv', 'X-XRDS-Location', 'value')) {
$url = $this->build_url(parse_url($url), parse_url($location));
continue;
}
}
if(!$content) $content = $this->request($url, 'GET');
# At this point, the YADIS Discovery has failed, so we'll switch
# to openid2 HTML discovery, then fallback to openid 1.1 discovery.
$server = $this->htmlTag($content, 'link', 'rel', 'openid2.provider', 'href');
$delegate = $this->htmlTag($content, 'link', 'rel', 'openid2.local_id', 'href');
$this->version = 2;
# Another hack for myopenid.com...
if(preg_match('/myopenid\.com/i', $server)) {
$server = null;
}
if(!$server) {
# The same with openid 1.1
$server = $this->htmlTag($content, 'link', 'rel', 'openid.server', 'href');
$delegate = $this->htmlTag($content, 'link', 'rel', 'openid.delegate', 'href');
$this->version = 1;
}
if($server) {
# We found an OpenID2 OP Endpoint
if($delegate) {
# We have also found an OP-Local ID.
$this->identity = $delegate;
}
$this->server = $server;
return $server;
}
throw new ErrorException('No servers found!');
}
throw new ErrorException('Endless redirection!');
}
[1]: http://gitorious.org/lightopenid
Хорошо, вот логика, как я ее понимаю (в основном):
- Проверьте, есть ли
$url
отправляет вам действительный файл XRDS, который вы затем анализируете, чтобы определить конечную точку провайдера OpenID.- Насколько я понимаю, это называется методом аутентификации Yadis.
- Если файл XRDS не найден, Проверьте тело ответа на наличие HTML-тега <link>, содержащего URL-адрес конечной точки..
Что..Черт.
Я имею в виду серьезно?По сути, вы сканируете ответ и надеетесь, что найдете ссылку с соответствующим значением атрибута?
Не поймите меня неправильно, этот класс работает просто великолепно, и это потрясающе.Я просто не могу понять два отдельных метода, используемых для обнаружения конечной точки:XRDS (ядис) и HTML.
Мои вопросы
- Это единственные два метода, используемые в процессе открытия?
- Один используется только в версии 1.1 OpenID, а другой — в версии 2?
- Критично ли поддерживать оба метода?
- Сайт, на котором я столкнулся с методом HTML, — Yahoo.Они сумасшедшие?
Еще раз спасибо за ваше время, ребята.Прошу прощения, если это звучит немного ошеломленно, но я был искренне ошеломлен этой методологией, когда начал понимать, какие меры принимаются для поиска конечной точки.
Решение
Спецификация твой друг.
Но отвечая на ваш вопрос:
- Да.Это единственные два метода, определенные спецификациями OpenID (по крайней мере, для URL-адресов — для XRI есть третий метод).
- Нет, оба могут использоваться с обеими версиями протокола.Внимательно прочитайте функцию, и вы увидите, что она поддерживает оба метода для обеих версий.
- Если вы хотите, чтобы ваша библиотека работала с каждым поставщиком и пользователем, вам лучше это сделать.Некоторые пользователи вставляют HTML-теги на свои сайты, поэтому URL-адрес их сайта можно использовать в качестве openid.
- Некоторые поставщики даже используют оба метода одновременно, чтобы обеспечить совместимость с потребителями, не реализующими обнаружение YADIS (которое не является частью OpenID 1.1, но может использоваться с ним).Так что это имеет смысл.
И да, обнаружение HTML — это поиск <link>
в теле ответа.Вот почему это называется обнаружением HTML.