.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================== EXT: 1 Click Login ================== :Created: 2010-02-18T17:33:18 :Changed by: Sebastian Gebhard :Changed: 2010-09-30T13:18:09.740000000 :Classification: oneclicklogin :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: openid, login :Author: Sebastian Michaelsen :Email: sebastian.gebhard@gmail.com :Info 4: :Language: en |img-1| |img-2| EXT: 1 Click Login - oneclicklogin .. _EXT-1-Click-Login: EXT: 1 Click Login ================== Extension Key: oneclicklogin Language: en Keywords: openid, login Copyright 2000-2010, Sebastian Michaelsen, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- `EXT: 1 Click Login 1 <#__RefHeading__596_134771385>`_ **`Introduction 3 <#__RefHeading__598_134771385>`_** `What does it do? 3 <#__RefHeading__600_134771385>`_ `Screenshots 3 <#__RefHeading__602_134771385>`_ **`Users manual 4 <#__RefHeading__604_134771385>`_** `What is OpenID? 4 <#__RefHeading__712_134771385>`_ `What OpenID provider should I choose? 4 <#__RefHeading__714_134771385>`_ `How do I enable myself for oneclicklogin? 4 <#__RefHeading__716_134771385>`_ `How do I log in using oneclicklogin? 4 <#__RefHeading__750_134771385>`_ **`Administration 5 <#__RefHeading__608_134771385>`_** `Installation 5 <#__RefHeading__784_134771385>`_ `A word on security 5 <#__RefHeading__788_134771385>`_ **`Configuration 6 <#__RefHeading__612_134771385>`_** `Extension Manager Options 6 <#__RefHeading__790_134771385>`_ **`Forge 7 <#__RefHeading__920_134771385>`_** **`About 8 <#__RefHeading__922_134771385>`_** `Who is this Sebastian Gebhard guy, Kasper is talking with in the podcast? 8 <#__RefHeading__924_134771385>`_ `Ah ok, and who is Sebastian Michaelsen? 8 <#__RefHeading__926_134771385>`_ .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ .. _Starting-position: Starting position """"""""""""""""" Using OpenID has some advantages in terms of security, maintainability and convenience but it can be quite unhandy for BE users to fill in their OpenID identifier every time. .. _How-to-make-the-login-even-faster-and-more-convenient: How to make the login even faster and more convenient """"""""""""""""""""""""""""""""""""""""""""""""""""" - Oneclicklogin gives you the possibility to show you user's names below the login form. With a single click on a name you will be logged in using the OpenID identifier of that user. So if you're already logged in at the OpenID provider you'll be in the Backend with a single click - Of course you can limit which users will be shown in the login form and also use devIPmask to hide the functionality from the public. .. _img-3-Screenshots: |img-3| Screenshots ^^^^^^^^^^^^^^^^^^^ .. _Users-manual: Users manual ------------ .. _What-is-OpenID: What is OpenID? ^^^^^^^^^^^^^^^ OpenID is a Single Signon technique which can give you access to different websites and applications with just one OpenID Account. Example: You register an OpenID Account at a certain OpenID Provider. Your identifier will be an URL and might look like http://yourname.youropenidprovider.org. Now you register yourself on website which has OpenID Support. Instead of giving a login name and password you just provide your OpenID identifier. The identifier itself is not a secret, so you don't have to share a private thing like a password with the website you want to register at. When you want to log in, into the page you just give your identifier. If you're already logged in at your OpenID Provider everything will happen in the background and you will jut be logged in. Otherwise you'll have to sign in to your Provider once. For more technical details see `http://en.wikipedia.org/wiki/OpenID `_ For TYPO3 that means that you as a User can store your OpenID identifier in the database instead of a password (if the admin enabled this option). At the login you just fill in your Identifier and no password. For details on OpenID usage with TYPO3 consult the manual of the openid System Extension. .. _What-OpenID-provider-should-I-choose: What OpenID provider should I choose? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Technically it doesn't matter which one you choose but it's crucial that you can trust that provider. I don't have a complete overview, but I made good experiences with `https://www.myopenid.com/ `_ but I'm sure there are also other good providers. In doubt: Google is your friend. There's also the possibility to set up your own OpenID server (for you as a single user or for a company or organisation with multiple users). .. _How-do-I-enable-myself-for-oneclicklogin: How do I enable myself for oneclicklogin? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You need to provide your OpenID identifier in your user record. If you still don't appear on the login screen, check if the “Enable 1-Click- Login via OpenID” option is set. If you don't have that option, ask your admin to set it for you. .. _img-4-How-do-I-log-in-using-oneclicklogin: |img-4| How do I log in using oneclicklogin? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Open the TYPO3 Login Form Search for your name Click on it Easy huh? .. _Administration: Administration -------------- .. _Installation: Installation ^^^^^^^^^^^^ oneclicklogin depends on the system extension “openid”, which is available since TYPO3 4.3. Install both extensions via the Extension Manager as usual. .. _A-word-on-security: A word on security ^^^^^^^^^^^^^^^^^^ When you use this Extension without a devIPmask limitation you will disclose the names and OpenID identifiers of your BE users to the public. This should not be a real security problem, but it might give potential attackers a few more ways to try to attack your site. (He can try to hack each of the OpenID Accounts to gain access to your site.) This is why you are encouraged to use the devIPmask feature if you have the possbility. .. _Configuration: Configuration ------------- .. _Extension-Manager-Options: Extension Manager Options ^^^^^^^^^^^^^^^^^^^^^^^^^ While you install oneclicklogin (and afterwards when you click on it in the Extension Manager list) you'll get to the Extension Manager Options of oneclicklogin: .. ### BEGIN~OF~TABLE ### .. _use-devIPmask: use\_devIPmask """""""""""""" .. container:: table-row Option use\_devIPmask Data type boolean Description If enabled there will be a check if a visitor matches $TYPO3\_CONF\_VARS[SYS][devIPmask] before showing the oneclicklogin. You can use this if you have a certain IP Pool for your BE Users. Default off .. _text-date: text\_date """""""""" .. container:: table-row Option text\_date Data type string Description oneclicklogin uses the Login News feature of TYPO3. That requires each element to have a headline consisting of a date and a text. This option configures the “date” (which doesn't need to be an actual date). Default “Extension” .. _text-headline: text\_headline """""""""""""" .. container:: table-row Option text\_headline Data type string Description See above. This options configures the text of the headline. Default “1 Click Login” .. ###### END~OF~TABLE ###### .. _Forge: Forge ----- Please use the forge page for feature requests and bug reports: `http://forge.typo3.org/projects/extension-oneclicklogin `_ .. _About: About ----- .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _Who-is-this-Sebastian-Gebhard-guy-Kasper-is-talking-with-in-the-podcast: Who is this Sebastian Gebhard guy, Kasper is talking with in the podcast? """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" The guy in the podcast ( `http://castor.t3o.punkt.de/files/oneclicklogin.mp4 `_ ) initially developed this extension. .. _Ah-ok-and-who-is-Sebastian-Michaelsen: Ah ok, and who is Sebastian Michaelsen? """"""""""""""""""""""""""""""""""""""" It's the same guy ;) Shortly before the Developer Days 2010 I married and changed my name. Unfortunatelly I did not tell it to the organziers in time so I was Sebastian Gebhard at that event and Kasper put my old name into the video. |img-2| 8 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 496 .. :id: Grafik1 .. :name: Grafik1 .. :width: 498 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 355 .. :id: Grafik3 .. :name: Grafik3 .. :width: 498