Autenticación

Autenticación por token

El modo de autenticación por token utiliza un token de seguridad personalizado proporcionado con URL. Al utilizar el token, su aplicación cliente REST obtendrá los mismos proyectos y equipos de pertenencia y permisos de seguridad que el usuario propietario del token.

Actualmente, Targetprocess admite y ofrece dos tipos diferentes de tokens:

Tokens de acceso personal configurados en la interfaz de usuario

Acceso a tokens de acceso personal

Para obtener y utilizar tokens de acceso personal, la función predeterminada del usuario debe tener habilitado el permiso Permitir crear y utilizar tokens de acceso.

De forma predeterminada, todas las funciones permiten el uso de tokens de acceso personal. Solo se evalúa el rol predeterminado de un usuario al determinar el acceso.

Si un usuario no tiene este permiso, no podrá:

• Acceda a la pestaña «Tokens de acceso personal»
• Crear nuevos tokens
• Autenticar utilizando tokens existentes (por ejemplo, tokens emitidos antes de revocar el permiso)

Acceso a tokens de acceso personal

• Usuarios sin privilegios administrativos: los usuarios sin privilegios administrativos solo pueden ver sus propios tokens en esta pestaña.
• Administradores: Los usuarios con derechos administrativos tienen acceso a todos los tokens de acceso personal del sistema, incluidos los que pertenecen a otros usuarios.

Para obtener más información, consulte la sección «Administración y control de tokens de acceso personal».

Obtener un token

Los usuarios pueden añadir los tokens en la pestaña «Tokens de acceso personal» en Configuración -> Autenticación y seguridad. Los administradores no pueden añadir tokens para otros usuarios.

Puedes usarlos todo el tiempo que quieras. Cuando el token ya no sea necesario, se podrá eliminar.

Por motivos de seguridad, se muestra un nuevo token que solo se puede copiar después de su creación. Puedes eliminar los tokens antiguos en caso de que no los recuerdes. Y puedes generar nuevos tokens siempre que lo necesites.

Puedes realizar un seguimiento del uso de tokens directamente desde la misma pestaña.

Usar token

El token recibido se puede utilizar con cualquier servicio REST añadiendo el parámetro de solicitud {token} access_token= a la URI.

GET /api/v1/UserStories/?access_token=YWRtaW46QUFBMEEwQTAwMEFBQTBBMDBBMEEwQTBBMEEwMEFBMDA=

• Usuario
• Nombre de token
• Fecha de emisión
• Última fecha de uso

*

Los administradores pueden eliminar cualquier token de usuario si es necesario para revocar el acceso o impedir el uso no autorizado de los datos.

Tokens generados por el servicio <b>/Authentication</b>

GET /api/v1/Authentication

<Authentication Token="YWRtaW46OTRDRDg2Qzg1NjgzQUZDMzg3Qjg2QTVERTAxRTZEQzY="/>

GET /api/v1/UserStories/?token=YWRtaW46QUFBMEEwQTAwMEFBQTBBMDBBMEEwQTBBMEEwMEFBMDA=

GET /api/v1/Authentication?login=mwhite

GET /api/v1/Authentication?login=System

Autenticación mediante cookies

Autenticación básica

GET /api/v1/UserStories/ HTTP/1.1
Authorization: Basic YWRtaW46YWRtaW4=

curl --user login:password /api/v1/userstories/

var webClient = new WebClient();
webClient.Credentials = new NetworkCredential("admin", "admin");

class UserStoryResource
  include HTTParty
  base_uri 'testaccount.tpondemand.com'
  format :xml
  def initialize(u, p)
    @auth = {:username => u, :password => p}
  end
  def all_stories(options={})
    options.merge!({:basic_auth => @auth})
    self.class.get("/api/v1/UserStories/", options)
  end
end
...
storyResource = UserStoryResource.new('admin', 'admin')
stories = storyResource.all_stories

Recuperar los datos del usuario registrado mediante la API

/api/v1/users/LoggedUser/

<User ResourceType="User" Id="334">
  <Kind>User</Kind>
  <FirstName>Teddy</FirstName>
  <LastName>Bear</LastName>
  <Email>xxx@xxx.com</Email>
  <Login>xxx</Login>
  <CreateDate>2006-10-02T16:19:42</CreateDate>
  <ModifyDate>2016-11-17T00:01:16</ModifyDate>
  <DeleteDate nil="true"/>
  <IsActive>true</IsActive>
  <IsAdministrator>true</IsAdministrator>
  <LastLoginDate>2016-11-17T00:00:00</LastLoginDate>
  <WeeklyAvailableHours>20.0000</WeeklyAvailableHours>
  <CurrentAllocation>100</CurrentAllocation>
  <CurrentAvailableHours>0.0000</CurrentAvailableHours>
  <AvailableFrom nil="true"/>
  <AvailableFutureAllocation>0</AvailableFutureAllocation>
  <AvailableFutureHours>0.0000</AvailableFutureHours>
  <IsObserver>false</IsObserver>
  <IsContributor nil="true"/>
  <Locale>en</Locale>
  <Skills>ui</Skills>
  <ActiveDirectoryName>TP\falcon</ActiveDirectoryName>
  <Role ResourceType="Role" Id="8" Name="Head"/>
  <CustomFields>
    <Field Type="Text">
      <Name>Skill Set</Name>
      <Value nil="true"/>
    </Field>
  </CustomFields>
</User>

Resolución de problemas

Usar token en la integración con Excel

&access_token=token_value

Error de usuario del sistema no autorizado