├── img
├── huh.txt
└── easyCertInstallScreenshot.png
├── EasyCertInstall
├── packages.config
├── App.config
├── Properties
│ └── AssemblyInfo.cs
├── app.manifest
├── EasyCertInstall.csproj
└── Program.cs
├── EasyCertInstall.sln
├── README.md
├── .gitattributes
└── .gitignore
/img/huh.txt:
--------------------------------------------------------------------------------
1 | :p
2 |
--------------------------------------------------------------------------------
/img/easyCertInstallScreenshot.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/colinkiama/EasyCertInstall/HEAD/img/easyCertInstallScreenshot.png
--------------------------------------------------------------------------------
/EasyCertInstall/packages.config:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
--------------------------------------------------------------------------------
/EasyCertInstall/App.config:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
--------------------------------------------------------------------------------
/EasyCertInstall.sln:
--------------------------------------------------------------------------------
1 |
2 | Microsoft Visual Studio Solution File, Format Version 12.00
3 | # Visual Studio 15
4 | VisualStudioVersion = 15.0.27703.2042
5 | MinimumVisualStudioVersion = 10.0.40219.1
6 | Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "EasyCertInstall", "EasyCertInstall\EasyCertInstall.csproj", "{8051E2FE-7F84-4310-B432-AE98EA34B1DB}"
7 | EndProject
8 | Global
9 | GlobalSection(SolutionConfigurationPlatforms) = preSolution
10 | Debug|Any CPU = Debug|Any CPU
11 | Release|Any CPU = Release|Any CPU
12 | EndGlobalSection
13 | GlobalSection(ProjectConfigurationPlatforms) = postSolution
14 | {8051E2FE-7F84-4310-B432-AE98EA34B1DB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
15 | {8051E2FE-7F84-4310-B432-AE98EA34B1DB}.Debug|Any CPU.Build.0 = Debug|Any CPU
16 | {8051E2FE-7F84-4310-B432-AE98EA34B1DB}.Release|Any CPU.ActiveCfg = Release|Any CPU
17 | {8051E2FE-7F84-4310-B432-AE98EA34B1DB}.Release|Any CPU.Build.0 = Release|Any CPU
18 | EndGlobalSection
19 | GlobalSection(SolutionProperties) = preSolution
20 | HideSolutionNode = FALSE
21 | EndGlobalSection
22 | GlobalSection(ExtensibilityGlobals) = postSolution
23 | SolutionGuid = {A33082BB-7C59-4E86-B377-17C8769253A8}
24 | EndGlobalSection
25 | EndGlobal
26 |
--------------------------------------------------------------------------------
/EasyCertInstall/Properties/AssemblyInfo.cs:
--------------------------------------------------------------------------------
1 | using System.Reflection;
2 | using System.Runtime.CompilerServices;
3 | using System.Runtime.InteropServices;
4 |
5 | // General Information about an assembly is controlled through the following
6 | // set of attributes. Change these attribute values to modify the information
7 | // associated with an assembly.
8 | [assembly: AssemblyTitle("EasyCertInstall")]
9 | [assembly: AssemblyDescription("")]
10 | [assembly: AssemblyConfiguration("")]
11 | [assembly: AssemblyCompany("")]
12 | [assembly: AssemblyProduct("EasyCertInstall")]
13 | [assembly: AssemblyCopyright("Copyright © 2018")]
14 | [assembly: AssemblyTrademark("")]
15 | [assembly: AssemblyCulture("")]
16 |
17 | // Setting ComVisible to false makes the types in this assembly not visible
18 | // to COM components. If you need to access a type in this assembly from
19 | // COM, set the ComVisible attribute to true on that type.
20 | [assembly: ComVisible(false)]
21 |
22 | // The following GUID is for the ID of the typelib if this project is exposed to COM
23 | [assembly: Guid("8051e2fe-7f84-4310-b432-ae98ea34b1db")]
24 |
25 | // Version information for an assembly consists of the following four values:
26 | //
27 | // Major Version
28 | // Minor Version
29 | // Build Number
30 | // Revision
31 | //
32 | // You can specify all the values or you can default the Build and Revision Numbers
33 | // by using the '*' as shown below:
34 | // [assembly: AssemblyVersion("1.0.*")]
35 | [assembly: AssemblyVersion("1.2.0.0")]
36 | [assembly: AssemblyFileVersion("1.2.0.0")]
37 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # EasyCertInstall
2 | A C# console program that makes it easy to install certificates for sideloaded UWP apps.
3 |
4 | ## Where to get the program:
5 | You can get the program from here: [EasyCertInstall Releases](https://github.com/colinkiama/EasyCertInstall/releases)
6 |
7 | ## How to use the program:
8 | ### 1. Using Windows Explorer:
9 | Start "EasyCertInstall.exe" in the directory where the certificate or signed app package with the certificate you want to install is located. The app will try to install a certificate file (.cer), that is located in the currently opened folder. If no certificate files are in the current folder, it will look for a signed .appxbundle file then as a last resort, it will look for a signed .appx file before giving up.
10 |
11 | ### 2. Using a command line program (e.g Command Prompt):
12 | You can run the app with a path to a directory or file as a parameter.
13 | For example:
14 | ```
15 | C:\>EasyCertInsall.exe [App Package Path]
16 | ```
17 | Usage Examples:
18 |
19 | ```
20 | //Program will install the "MyAppCert" certificate
21 | C:\>EasyCertInsall.exe C:\Certs\MyAppCert.cer
22 |
23 | // MyApp.appxbundle is located in the "C:\AppPkg". There is no certificate file (.cer) there.
24 | // This will install the certificate from "MyApp.appxbundle"
25 | C:\>EasyCertInsall.exe C:\AppPkg
26 |
27 |
28 | ```
29 |
30 |
31 | ### For heavy command line users:
32 | You can follow this tutorial to add the folder where this progam is contained to the Path environment variable: https://helpdeskgeek.com/windows-10/add-windows-path-environment-variable/
33 |
34 | After you do this, you'll be able to simply use "EasyCertInstall" from anywhere in the command line!
35 |
36 | ## Roadmap:
37 | - [x] Installing certificates from certificate files
38 | - [x] Installing certificates from the signed package
39 | - [x] Installing certificates from from path passed in as an argument.
40 |
41 |
--------------------------------------------------------------------------------
/.gitattributes:
--------------------------------------------------------------------------------
1 | ###############################################################################
2 | # Set default behavior to automatically normalize line endings.
3 | ###############################################################################
4 | * text=auto
5 |
6 | ###############################################################################
7 | # Set default behavior for command prompt diff.
8 | #
9 | # This is need for earlier builds of msysgit that does not have it on by
10 | # default for csharp files.
11 | # Note: This is only used by command line
12 | ###############################################################################
13 | #*.cs diff=csharp
14 |
15 | ###############################################################################
16 | # Set the merge driver for project and solution files
17 | #
18 | # Merging from the command prompt will add diff markers to the files if there
19 | # are conflicts (Merging from VS is not affected by the settings below, in VS
20 | # the diff markers are never inserted). Diff markers may cause the following
21 | # file extensions to fail to load in VS. An alternative would be to treat
22 | # these files as binary and thus will always conflict and require user
23 | # intervention with every merge. To do so, just uncomment the entries below
24 | ###############################################################################
25 | #*.sln merge=binary
26 | #*.csproj merge=binary
27 | #*.vbproj merge=binary
28 | #*.vcxproj merge=binary
29 | #*.vcproj merge=binary
30 | #*.dbproj merge=binary
31 | #*.fsproj merge=binary
32 | #*.lsproj merge=binary
33 | #*.wixproj merge=binary
34 | #*.modelproj merge=binary
35 | #*.sqlproj merge=binary
36 | #*.wwaproj merge=binary
37 |
38 | ###############################################################################
39 | # behavior for image files
40 | #
41 | # image files are treated as binary by default.
42 | ###############################################################################
43 | #*.jpg binary
44 | #*.png binary
45 | #*.gif binary
46 |
47 | ###############################################################################
48 | # diff behavior for common document formats
49 | #
50 | # Convert binary document formats to text before diffing them. This feature
51 | # is only available from the command line. Turn it on by uncommenting the
52 | # entries below.
53 | ###############################################################################
54 | #*.doc diff=astextplain
55 | #*.DOC diff=astextplain
56 | #*.docx diff=astextplain
57 | #*.DOCX diff=astextplain
58 | #*.dot diff=astextplain
59 | #*.DOT diff=astextplain
60 | #*.pdf diff=astextplain
61 | #*.PDF diff=astextplain
62 | #*.rtf diff=astextplain
63 | #*.RTF diff=astextplain
64 |
--------------------------------------------------------------------------------
/EasyCertInstall/app.manifest:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
19 |
20 |
21 |
22 |
23 |
24 |
25 |
26 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
52 |
59 |
60 |
61 |
75 |
76 |
77 |
--------------------------------------------------------------------------------
/EasyCertInstall/EasyCertInstall.csproj:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | Debug
6 | AnyCPU
7 | {8051E2FE-7F84-4310-B432-AE98EA34B1DB}
8 | Exe
9 | EasyCertInstall
10 | EasyCertInstall
11 | v4.6.1
12 | 512
13 | true
14 | publish\
15 | true
16 | Disk
17 | false
18 | Foreground
19 | 7
20 | Days
21 | false
22 | false
23 | true
24 | 0
25 | 1.0.0.%2a
26 | false
27 | false
28 | true
29 |
30 |
31 | AnyCPU
32 | true
33 | full
34 | false
35 | bin\Debug\
36 | DEBUG;TRACE
37 | prompt
38 | 4
39 |
40 |
41 | AnyCPU
42 | pdbonly
43 | true
44 | bin\Release\
45 | TRACE
46 | prompt
47 | 4
48 |
49 |
50 | app.manifest
51 |
52 |
53 |
54 |
55 |
56 | ..\packages\System.ValueTuple.4.5.0\lib\net461\System.ValueTuple.dll
57 |
58 |
59 |
60 |
61 |
62 |
63 |
64 |
65 |
66 |
67 |
68 |
69 |
70 |
71 |
72 | Designer
73 |
74 |
75 |
76 |
77 |
78 | False
79 | Microsoft .NET Framework 4.6.1 %28x86 and x64%29
80 | true
81 |
82 |
83 | False
84 | .NET Framework 3.5 SP1
85 | false
86 |
87 |
88 |
89 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | ## Ignore Visual Studio temporary files, build results, and
2 | ## files generated by popular Visual Studio add-ons.
3 |
4 | # User-specific files
5 | *.suo
6 | *.user
7 | *.userosscache
8 | *.sln.docstates
9 |
10 | # User-specific files (MonoDevelop/Xamarin Studio)
11 | *.userprefs
12 |
13 | # Build results
14 | [Dd]ebug/
15 | [Dd]ebugPublic/
16 | [Rr]elease/
17 | [Rr]eleases/
18 | x64/
19 | x86/
20 | bld/
21 | [Bb]in/
22 | [Oo]bj/
23 | [Ll]og/
24 |
25 | # Visual Studio 2015 cache/options directory
26 | .vs/
27 | # Uncomment if you have tasks that create the project's static files in wwwroot
28 | #wwwroot/
29 |
30 | # MSTest test Results
31 | [Tt]est[Rr]esult*/
32 | [Bb]uild[Ll]og.*
33 |
34 | # NUNIT
35 | *.VisualState.xml
36 | TestResult.xml
37 |
38 | # Build Results of an ATL Project
39 | [Dd]ebugPS/
40 | [Rr]eleasePS/
41 | dlldata.c
42 |
43 | # DNX
44 | project.lock.json
45 | project.fragment.lock.json
46 | artifacts/
47 |
48 | *_i.c
49 | *_p.c
50 | *_i.h
51 | *.ilk
52 | *.meta
53 | *.obj
54 | *.pch
55 | *.pdb
56 | *.pgc
57 | *.pgd
58 | *.rsp
59 | *.sbr
60 | *.tlb
61 | *.tli
62 | *.tlh
63 | *.tmp
64 | *.tmp_proj
65 | *.log
66 | *.vspscc
67 | *.vssscc
68 | .builds
69 | *.pidb
70 | *.svclog
71 | *.scc
72 |
73 | # Chutzpah Test files
74 | _Chutzpah*
75 |
76 | # Visual C++ cache files
77 | ipch/
78 | *.aps
79 | *.ncb
80 | *.opendb
81 | *.opensdf
82 | *.sdf
83 | *.cachefile
84 | *.VC.db
85 | *.VC.VC.opendb
86 |
87 | # Visual Studio profiler
88 | *.psess
89 | *.vsp
90 | *.vspx
91 | *.sap
92 |
93 | # TFS 2012 Local Workspace
94 | $tf/
95 |
96 | # Guidance Automation Toolkit
97 | *.gpState
98 |
99 | # ReSharper is a .NET coding add-in
100 | _ReSharper*/
101 | *.[Rr]e[Ss]harper
102 | *.DotSettings.user
103 |
104 | # JustCode is a .NET coding add-in
105 | .JustCode
106 |
107 | # TeamCity is a build add-in
108 | _TeamCity*
109 |
110 | # DotCover is a Code Coverage Tool
111 | *.dotCover
112 |
113 | # NCrunch
114 | _NCrunch_*
115 | .*crunch*.local.xml
116 | nCrunchTemp_*
117 |
118 | # MightyMoose
119 | *.mm.*
120 | AutoTest.Net/
121 |
122 | # Web workbench (sass)
123 | .sass-cache/
124 |
125 | # Installshield output folder
126 | [Ee]xpress/
127 |
128 | # DocProject is a documentation generator add-in
129 | DocProject/buildhelp/
130 | DocProject/Help/*.HxT
131 | DocProject/Help/*.HxC
132 | DocProject/Help/*.hhc
133 | DocProject/Help/*.hhk
134 | DocProject/Help/*.hhp
135 | DocProject/Help/Html2
136 | DocProject/Help/html
137 |
138 | # Click-Once directory
139 | publish/
140 |
141 | # Publish Web Output
142 | *.[Pp]ublish.xml
143 | *.azurePubxml
144 | # TODO: Comment the next line if you want to checkin your web deploy settings
145 | # but database connection strings (with potential passwords) will be unencrypted
146 | #*.pubxml
147 | *.publishproj
148 |
149 | # Microsoft Azure Web App publish settings. Comment the next line if you want to
150 | # checkin your Azure Web App publish settings, but sensitive information contained
151 | # in these scripts will be unencrypted
152 | PublishScripts/
153 |
154 | # NuGet Packages
155 | *.nupkg
156 | # The packages folder can be ignored because of Package Restore
157 | **/packages/*
158 | # except build/, which is used as an MSBuild target.
159 | !**/packages/build/
160 | # Uncomment if necessary however generally it will be regenerated when needed
161 | #!**/packages/repositories.config
162 | # NuGet v3's project.json files produces more ignoreable files
163 | *.nuget.props
164 | *.nuget.targets
165 |
166 | # Microsoft Azure Build Output
167 | csx/
168 | *.build.csdef
169 |
170 | # Microsoft Azure Emulator
171 | ecf/
172 | rcf/
173 |
174 | # Windows Store app package directories and files
175 | AppPackages/
176 | BundleArtifacts/
177 | Package.StoreAssociation.xml
178 | _pkginfo.txt
179 |
180 | # Visual Studio cache files
181 | # files ending in .cache can be ignored
182 | *.[Cc]ache
183 | # but keep track of directories ending in .cache
184 | !*.[Cc]ache/
185 |
186 | # Others
187 | ClientBin/
188 | ~$*
189 | *~
190 | *.dbmdl
191 | *.dbproj.schemaview
192 | *.jfm
193 | *.pfx
194 | *.publishsettings
195 | node_modules/
196 | orleans.codegen.cs
197 |
198 | # Since there are multiple workflows, uncomment next line to ignore bower_components
199 | # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
200 | #bower_components/
201 |
202 | # RIA/Silverlight projects
203 | Generated_Code/
204 |
205 | # Backup & report files from converting an old project file
206 | # to a newer Visual Studio version. Backup files are not needed,
207 | # because we have git ;-)
208 | _UpgradeReport_Files/
209 | Backup*/
210 | UpgradeLog*.XML
211 | UpgradeLog*.htm
212 |
213 | # SQL Server files
214 | *.mdf
215 | *.ldf
216 |
217 | # Business Intelligence projects
218 | *.rdl.data
219 | *.bim.layout
220 | *.bim_*.settings
221 |
222 | # Microsoft Fakes
223 | FakesAssemblies/
224 |
225 | # GhostDoc plugin setting file
226 | *.GhostDoc.xml
227 |
228 | # Node.js Tools for Visual Studio
229 | .ntvs_analysis.dat
230 |
231 | # Visual Studio 6 build log
232 | *.plg
233 |
234 | # Visual Studio 6 workspace options file
235 | *.opt
236 |
237 | # Visual Studio LightSwitch build output
238 | **/*.HTMLClient/GeneratedArtifacts
239 | **/*.DesktopClient/GeneratedArtifacts
240 | **/*.DesktopClient/ModelManifest.xml
241 | **/*.Server/GeneratedArtifacts
242 | **/*.Server/ModelManifest.xml
243 | _Pvt_Extensions
244 |
245 | # Paket dependency manager
246 | .paket/paket.exe
247 | paket-files/
248 |
249 | # FAKE - F# Make
250 | .fake/
251 |
252 | # JetBrains Rider
253 | .idea/
254 | *.sln.iml
255 |
256 | # CodeRush
257 | .cr/
258 |
259 | # Python Tools for Visual Studio (PTVS)
260 | __pycache__/
261 | *.pyc
--------------------------------------------------------------------------------
/EasyCertInstall/Program.cs:
--------------------------------------------------------------------------------
1 | using System;
2 | using System.Collections.Generic;
3 | using System.Linq;
4 | using System.Security.Cryptography.X509Certificates;
5 | using System.Text;
6 | using System.Threading.Tasks;
7 | using System.IO;
8 | using System.Diagnostics;
9 |
10 | namespace EasyCertInstall
11 | {
12 | class Program
13 | {
14 | static void Main(string[] args)
15 | {
16 | if (args.Length > 0)
17 | {
18 | string filePath = args[0];
19 | bool doesFileExist = System.IO.File.Exists(filePath);
20 | if (doesFileExist)
21 | {
22 | string fileExtension = filePath.Split('.')[1];
23 | if (fileExtension == ".cer")
24 | {
25 | InstallCertFromCertFilePath(filePath);
26 | }
27 | else if (fileExtension == ".appx" || fileExtension == ".appxbundle")
28 | {
29 | InstallCertFromSignedPackage(filePath);
30 | }
31 | }
32 | else if (Directory.Exists(args[0]))
33 | {
34 | InstallCertFromDirectory(args[0]);
35 | }
36 | else
37 | {
38 | Console.WriteLine("Invalid parameters were entered. Please enter a path to a certificate file \".cer\" app package file \".appx\" or \".appxbundle\" or a directory");
39 | }
40 | }
41 |
42 | else
43 | {
44 | string currentDirectory = Directory.GetCurrentDirectory();
45 | InstallCertFromDirectory(currentDirectory);
46 | }
47 |
48 |
49 |
50 |
51 |
52 | Console.ReadLine();
53 | }
54 |
55 | private static void InstallCertFromDirectory(string currentDirectory)
56 | {
57 | Console.WriteLine($"Current directory is: {currentDirectory}");
58 | var files = Directory.GetFiles(currentDirectory, "*.cer");
59 |
60 |
61 | if (files.Length > 0)
62 | {
63 | string certFileName = files.First();
64 | X509Certificate2 cert = new X509Certificate2(certFileName);
65 | using (X509Store store = new X509Store(StoreName.TrustedPeople, StoreLocation.LocalMachine))
66 | {
67 | store.Open(OpenFlags.ReadWrite);
68 | store.Add(cert);
69 | }
70 | Console.WriteLine($"{certFileName} has successfully been added to the certifcate store.");
71 | Console.WriteLine("You can now easily install the app by double clicking the .appx/.appxbundle file");
72 | }
73 |
74 | else
75 | {
76 | InstallCertFromSignedPackageFromDirectory();
77 | }
78 |
79 |
80 | }
81 |
82 | private static void InstallCertFromSignedPackage(string filePath)
83 | {
84 | PrintFilePath(filePath);
85 | X509Certificate certFromSignedPkg = X509Certificate.CreateFromSignedFile(filePath);
86 | X509Certificate2 cert = new X509Certificate2(certFromSignedPkg);
87 | using (X509Store store = new X509Store(StoreName.TrustedPeople, StoreLocation.LocalMachine))
88 | {
89 | store.Open(OpenFlags.ReadWrite);
90 | store.Add(cert);
91 | }
92 | Console.WriteLine($"Certificate for signed package: {filePath} has successfully been added to the certifcate store.");
93 | Console.WriteLine("You can now easily install the app by double clicking the .appx/.appxbundle file");
94 | }
95 |
96 | private static void InstallCertFromCertFilePath(string filePath)
97 | {
98 | PrintFilePath(filePath);
99 | X509Certificate2 cert = new X509Certificate2(filePath);
100 | using (X509Store store = new X509Store(StoreName.TrustedPeople, StoreLocation.LocalMachine))
101 | {
102 | store.Open(OpenFlags.ReadWrite);
103 | store.Add(cert);
104 | }
105 | Console.WriteLine($"{filePath} has successfully been added to the certifcate store.");
106 | Console.WriteLine("You can now easily install the app by double clicking the .appx/.appxbundle file");
107 | }
108 |
109 | private static void PrintFilePath(string filePath)
110 | {
111 | Console.WriteLine($"Current file path: {filePath}");
112 | }
113 |
114 | private static void InstallCertFromSignedPackageFromDirectory()
115 | {
116 | string currentDirectory = Directory.GetCurrentDirectory();
117 | string signedPackagePath = TryFindSignedPackagePath(currentDirectory);
118 |
119 |
120 | if (signedPackagePath != "null")
121 | {
122 | InstallCertFromSignedPackage(signedPackagePath);
123 | }
124 |
125 | else
126 | {
127 | Console.WriteLine("Certificate file or signed package is not available in the current directory.");
128 | Console.WriteLine("Please launch this program in the directory where the certifcate file or appx you want to install is located");
129 | }
130 | }
131 |
132 |
133 |
134 | private static string TryFindSignedPackagePath(string currentDirectory)
135 | {
136 | string packagePath = "null";
137 |
138 | Tuple fileQueryResult = FindFilesFromDirectory(currentDirectory, "*.appxbundle");
139 | if (fileQueryResult.Item1 == true)
140 | {
141 | packagePath = fileQueryResult.Item2;
142 | }
143 |
144 | else
145 | {
146 | fileQueryResult = FindFilesFromDirectory(currentDirectory, "*.appx");
147 | if (fileQueryResult.Item1 == true)
148 | {
149 | packagePath = fileQueryResult.Item2;
150 | }
151 |
152 | }
153 |
154 | return packagePath;
155 | }
156 |
157 | private static Tuple FindFilesFromDirectory(string currentDirectory, string searchPattern)
158 | {
159 | string fileName = "";
160 | bool isFileFound = false;
161 |
162 | var files = Directory.GetFiles(currentDirectory, searchPattern);
163 | if (files.Length > 0)
164 | {
165 | isFileFound = true;
166 | fileName = files[0];
167 | }
168 |
169 | return Tuple.Create(isFileFound, fileName);
170 | }
171 | }
172 | }
173 |
--------------------------------------------------------------------------------