gnu-social/socialfy-your-domain
Mikael Nordfeldth a0e107f17f Implemented WebFinger and replaced our XRD with PEAR XML_XRD
New plugins:
* LRDD
    LRDD implements client-side RFC6415 and RFC7033 resource descriptor
    discovery procedures. I.e. LRDD, host-meta and WebFinger stuff.

    OStatus and OpenID now depend on the LRDD plugin (XML_XRD).

* WebFinger
    This plugin implements the server-side of RFC6415 and RFC7033. Note:
    WebFinger technically doesn't handle XRD, but we serve both that and
    JRD (JSON Resource Descriptor), depending on Accept header and one
    ugly hack to check for old StatusNet installations.

    WebFinger depends on LRDD.

We might make this even prettier by using Net_WebFinger, but it is not
currently RFC7033 compliant (no /.well-known/webfinger resource GETs).

Disabling the WebFinger plugin would effectively render your site non-
federated (which might be desired on a private site).

Disabling the LRDD plugin would make your site unable to do modern web
URI lookups (making life just a little bit harder).
2013-09-30 22:04:52 +02:00
..
dot-well-known Implemented WebFinger and replaced our XRD with PEAR XML_XRD 2013-09-30 22:04:52 +02:00
xrd added some crude code to enable people to add support for webfinger to 2010-08-07 14:29:24 -04:00
README.txt added some crude code to enable people to add support for webfinger to 2010-08-07 14:29:24 -04:00

README.txt

Initial simple way to Webfinger enable your domain -- needs PHP.
================================================================

Step 1
======

First, put the folders 'xrd' and 'dot-well-known' on your website, so
they load at:

     http://yourname.com/xrd/

     and

     http://yourname.com/.well-known/

     (Remember the . at the beginning of this one)

Step 2
======

Next, edit xrd/index.php and enter a secret in this line:

$s = "";

This can be anything you like...

$s = "johnny-five";

or 

$s = "12345";

It really doesn't matter too much.

Step 3
======

For each user on your site, and this might only be you...

Make a copy of the example@example.com.xml file so that it's called...

     yoursecretusername@domain.com.xml

     So, if your secret is 'johnny5' and your name is ben and your
     domain is titanictoycorp.biz, your file should be called
     johnny5ben@titanictoycorp.biz.xml

Finally, edit the file to point at your account on your social
site. If you are the only user, then you probably don't need to worry
about user/1 as this will be you. For multi user sites, the user ID is
on the profile page.

Finally
=======

Using this method, though fiddly, you can now be @user@domain without
the need for any prefixes for subdomains, etc.