{"id":233,"date":"2013-01-07T07:09:00","date_gmt":"2013-01-07T07:09:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/buckh\/2013\/01\/07\/how-to-connect-to-tf-service-without-a-prompt-for-liveid-credentials\/"},"modified":"2013-01-07T07:09:00","modified_gmt":"2013-01-07T07:09:00","slug":"how-to-connect-to-tf-service-without-a-prompt-for-liveid-credentials","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/buckh\/how-to-connect-to-tf-service-without-a-prompt-for-liveid-credentials\/","title":{"rendered":"How to connect to TF Service without a prompt for LiveID credentials"},"content":{"rendered":"

Normally when you connect to the Team Foundation Service<\/a> you are presented with a web page to log in with your Microsoft Account (aka LiveID). When you log in you can choose to have it remember you and you won\u2019t have to enter your Microsoft Account credentials again (unless you don\u2019t log in again for a long time, and then you\u2019ll be prompted again).<\/p>\n

That\u2019s great for humans, but what about an application or another web service that wants to connect? For that the code will need to use \u201calternate credentials," which you must enable on your account. This is the same setting used to enable basic authentication for git-tf<\/a>. Then we can write some code to connect to the service with those credentials.<\/p>\n

Longer term, we will have OAuth support available as well, but that\u2019s not ready yet.<\/p>\n

Enabling Alternate Credentials<\/strong><\/p>\n

You\u2019ll need to first to turn on this feature. First, visit your account or project in a browser, click on your name in the upper right, and then click My Profile.<\/p>\n

\"myprofile\"<\/a><\/p>\n

On the User Profile dialog, click on the Credentials tab.<\/p>\n

\"enablecreds\"<\/a><\/p>\n

Now provide a password and save the changes.<\/p>\n

\"password\"<\/a><\/p>\n

Using Alternate Credentials in code<\/strong><\/p>\n

Before going further, you\u2019ll need to make sure that you have Update 1 for Visual Studio 2012 or newer installed. That update includes enhancements to the TFS client object model to support alternate credentials.<\/p>\n

The easiest way to get the latest update is either via clicking on the \u201ctoast\u201d notification that pops up from the Windows taskbar or in VS going to Tools \u2013> Extensions and Updates\u2026, clicking on Updates followed by Product Updates and installing the latest update. Alternatively, you can download it here<\/a>.<\/p>\n

You can verify that you have Update 1 (or newer) installed in VS using Help \u2013> About Microsoft Visual Studio.<\/p>\n

\"vshelp\"<\/a><\/p>\n

Now that we have the credentials turned on, we\u2019ll now use them from a simple console app.<\/p>\n

 <\/pre>\n
After creating a new console app, add a reference to Microsoft.TeamFoundation.Client.dll, which you will find under v2.0 in ReferenceAssemblies. The client object model for TFS is almost entirely built with .NET 3.5 (CLR 2.0) in order to support running the TFS web parts in SharePoint.<\/p>\n
\"image\"<\/a><\/p>\n
Here\u2019s the code.<\/p>\n
using <\/span>System;\n<\/span>using <\/span>System.Collections.Generic;\n<\/span>using <\/span>System.Linq;\n<\/span>using <\/span>System.Net;\n<\/span>using <\/span>System.Text;\n<\/span>using <\/span>System.Threading.Tasks;\n\n<\/span>using <\/span>Microsoft.TeamFoundation.Client;\n\n<\/span>namespace <\/span>ConsoleApplication1\n{\n    <\/span>class <\/span>Program\n    <\/span>{\n        <\/span>static void <\/span>Main(<\/span>string<\/span>[] args)\n        {\n            <\/span>NetworkCredential <\/span>netCred = <\/span>new <\/span>NetworkCredential<\/span>(\n                <\/span>"someone@yahoo.com"<\/span>,\n                <\/span>"password"<\/span>);\n            <\/span>BasicAuthCredential <\/span>basicCred = <\/span>new <\/span>BasicAuthCredential<\/span>(netCred);\n            <\/span>TfsClientCredentials <\/span>tfsCred = <\/span>new <\/span>TfsClientCredentials<\/span>(basicCred);\n            tfsCred.AllowInteractive = <\/span>false<\/span>;\n\n            <\/span>TfsTeamProjectCollection <\/span>tpc = <\/span>new <\/span>TfsTeamProjectCollection<\/span>(\n                <\/span>new <\/span>Uri<\/span>(<\/span>"https:\/\/YourAcct.visualstudio.com\/DefaultCollection"<\/span>),\n                tfsCred);\n\n            tpc.Authenticate();\n\n            <\/span>Console<\/span>.WriteLine(tpc.InstanceId);\n        }\n    }\n}<\/span><\/pre>\n
I\u2019ve added two using statements, one for System.Net<\/span> to pull in NetworkCredential<\/span> and one for Microsoft.TeamFoundation.Client<\/span> for the TFS classes we\u2019ll need.<\/p>\n
The first thing we construct is a standard NetworkCredential<\/span> object with the username (the email address that you use for your Microsoft Account) and the password that you created for alternate credentials. On the TfsClientCredentials<\/span> object, we set AllowInteractive<\/span> to false to prevent a prompt dialog being shown if the credentials are invalid.<\/p>\n
In constructing the TfsTeamProjectCollection<\/span>, we must specify the URL to the collection and the credentials. Note that all connections to accounts in TF Service require https. Currently, there is only one collection per account in TF Service, so it is always DefaultCollection.<\/p>\n
Finally, we call Authenticate()<\/span> to verify that we have supplied the correct credentials and test that it is working by printing the unique InstanceId<\/span> of the collection.<\/p>\n
Now the rest of the TFS client object model is available for use with the TF Service from applications that cannot prompt for credentials.<\/p>\n
Enjoy!<\/p>\n
Follow me on Twitter at <\/em>https:\/\/twitter.com\/tfsbuck<\/em><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Normally when you connect to the Team Foundation Service you are presented with a web page to log in with your Microsoft Account (aka LiveID). When you log in you can choose to have it remember you and you won\u2019t have to enter your Microsoft Account credentials again (unless you don\u2019t log in again for […]<\/p>\n","protected":false},"author":94,"featured_media":10268,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[8,15,17],"class_list":["post-233","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","tag-team-foundation","tag-tfs-api","tag-tfservice"],"acf":[],"blog_post_summary":"
Normally when you connect to the Team Foundation Service you are presented with a web page to log in with your Microsoft Account (aka LiveID). When you log in you can choose to have it remember you and you won\u2019t have to enter your Microsoft Account credentials again (unless you don\u2019t log in again for […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/buckh\/wp-json\/wp\/v2\/posts\/233","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/buckh\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/buckh\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/buckh\/wp-json\/wp\/v2\/users\/94"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/buckh\/wp-json\/wp\/v2\/comments?post=233"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/buckh\/wp-json\/wp\/v2\/posts\/233\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/buckh\/wp-json\/wp\/v2\/media\/10268"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/buckh\/wp-json\/wp\/v2\/media?parent=233"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/buckh\/wp-json\/wp\/v2\/categories?post=233"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/buckh\/wp-json\/wp\/v2\/tags?post=233"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}