Методы обнаружения OpenID - Yadis VS HTML - PullRequest
6 голосов
/ 16 июля 2010

Недавно я начал писать свой собственный потребительский класс PHP OpenID, чтобы лучше понимать openID. В качестве руководства я ссылаюсь на [LightOpenID Class] [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

Хорошо, вот логика, насколько я понимаю (в основном):

  1. Проверьте, отправляет ли $url действительный файл XRDS, который вы затем анализируете, чтобы выяснить конечную точку поставщика OpenID.
    • Насколько я понимаю, это называется методом аутентификации Yadis.
  2. Если XRDS-файл не найден, Проверьте тело ответа на наличие тега HTML , содержащего URL-адрес конечной точки .

Что. . Хек. * * 1 021

Я имею в виду серьезно? По сути скрининг ответа и надеюсь, что вы найдете ссылку с соответствующим значением атрибута?

Теперь, не поймите меня неправильно, этот класс работает как обаяние, и это круто. Я просто не могу использовать два отдельных метода, используемых для обнаружения конечной точки: XRDS (yadis) и HTML.

Мои вопросы

  1. Это единственные два метода, используемые в процессе обнаружения?
  2. Один используется только в версии 1.1 OpenID, а другой - в версии 2?
  3. Важно ли поддерживать оба метода?
  4. Сайт, с которым я столкнулся с методом HTML, - это Yahoo. Они чокнутые?

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

1 Ответ

6 голосов
/ 17 июля 2010

Спецификация ваш друг.

Но отвечая на ваш вопрос:

  1. Да. Это единственные два метода, определенные спецификациями OpenID (по крайней мере, для URL - есть третий метод для XRI).
  2. Нет, оба могут использоваться с обеими версиями протокола. Внимательно прочитайте функцию, и вы увидите, что она поддерживает оба метода для обеих версий.
  3. Если вы хотите, чтобы ваша библиотека работала со всеми провайдерами и пользователями, вам лучше это сделать. Некоторые пользователи вставляют теги HTML на свои сайты, поэтому URL их сайта можно использовать в качестве openid.
  4. Некоторые провайдеры даже используют оба метода одновременно, чтобы обеспечить совместимость с потребителями, не внедряющими обнаружение YADIS (которое не является частью OpenID 1.1, но может использоваться с ним). Так что это имеет смысл.

И да, обнаружение HTML связано с поиском <link> в теле ответа. Вот почему это называется открытием HTML.

...