Authentification

Authentification par jeton

Le mode d'authentification par jeton utilise un jeton de sécurité personnalisé fourni avec URL. Grâce au jeton, votre application cliente REST obtiendra les mêmes autorisations en matière de projets, d'appartenance à des équipes et de sécurité que celles dont dispose l'utilisateur propriétaire du jeton.

Deux types de jetons différents sont désormais disponibles et pris en charge dans Targetprocess :

Jetons d'accès personnels définis dans l'interface utilisateur

Accès aux jetons d'accès personnels

Pour obtenir et utiliser des jetons d'accès personnels, le rôle par défaut d'un utilisateur doit disposer de l 'autorisation Créer et utiliser des jetons d'accès.

Par défaut, tous les rôles autorisent l'utilisation de jetons d'accès personnels. Seul le rôle par défaut d'un utilisateur est évalué lors de la détermination de l'accès.

Si un utilisateur ne dispose pas de cette autorisation, il ne pourra pas :

• Accédez à l'onglet Jetons d'accès personnels
• Créer de nouveaux jetons
• Authentification à l'aide de jetons existants (par exemple, jetons émis avant la révocation de l'autorisation)

Accès aux jetons d'accès personnels

• Non-administrateurs : les utilisateurs ne disposant pas de privilèges administratifs peuvent uniquement consulter leurs propres jetons dans cet onglet.
• Administrateurs : les utilisateurs disposant de droits d'administration ont accès à tous les jetons d'accès personnels du système, y compris ceux appartenant à d'autres utilisateurs.

Pour plus d'informations, consultez la section « Administration et contrôle des jetons d'accès personnels ».

Obtenir un jeton

Les utilisateurs peuvent ajouter les jetons sous l'onglet Jetons d'accès personnels dans Paramètres -> Authentification et sécurité. Les administrateurs ne peuvent pas ajouter de jetons pour d'autres utilisateurs.

Vous pouvez les utiliser aussi longtemps que vous le souhaitez. Lorsque le jeton n'est plus nécessaire, il peut être supprimé.

Pour des raisons de sécurité, un nouveau jeton s'affiche et ne peut être copié qu'après sa création. Vous pouvez supprimer les anciens jetons si vous ne vous en souvenez plus. Et vous pouvez générer de nouveaux jetons chaque fois que vous en avez besoin.

Vous pouvez suivre l'utilisation des jetons directement à partir du même onglet.

Utiliser le jeton

Le jeton reçu peut être utilisé avec n'importe quel service REST en ajoutant le paramètre de requête {token} access_token= à l'URI.

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

• Utilisateur
• Nom de jeton
• Date d'émission
• Date de dernière utilisation

*

Les administrateurs peuvent supprimer tout jeton utilisateur si nécessaire afin de révoquer l'accès ou d'empêcher l'utilisation non autorisée des données.

Jetons générés par le service <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

Authentification par cookie

Authentification de base

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

Récupérer les informations de connexion de l'utilisateur à l'aide de l'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>

Traitement des incidents

Utiliser le jeton dans l'intégration Excel

&access_token=token_value

Erreur non autorisée pour l'utilisateur système