Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Readme instructions do not produce correct Signature Hash

Open
#58 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
55/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
android, azure, java

Research direction

Read the README section on using your own App Registration, especially Step 5, and inspect the build files to confirm which project keystore the sample uses. Update the instructions to explain that the sample uses its own keystore and how the keytool command should reference it; verify the wording by following the customer setup and checking the generated redirect URI.

Written by the indexing model from the issue text.

Description

Please provide us with the following information:

This issue is for a: (mark with an x)
- [ ] bug report -> please search issues before submitting
- [ ] feature request
- [ x ] documentation issue or request
- [ ] regression (a behavior that used to work and stopped in a new release)
Minimal steps to reproduce

Our customers follow the directions in readme file to connect to their own tenant
-clone the repository
-build in Android studio
-create App Registration in Azure Portal
-create redirect Uri using the package name and Hash generated from the Azure Portal instructions
-create json config file and intent-filter based on the information generated in the Azure Portal

Any log messages given by the failure

This produces an Msal exception:
com.microsoft.identity.client.exception.MsalClientException: The redirect URI in the configuration file doesn't match with the one generated with package name and signature hash. Please verify the uri in the config file and your app registration in Azure portal.

Expected/desired behavior

Our customers should be able to get our fundamental sample working with their own tenant by following the directions in the readme and official documentation

OS and Version?

Any recent version of Android

Versions

2.21

Mention any other details that might be useful

Hi Team!

I am a Microsoft Support Engineer who supports Msal. Our customers are frustrated with this sample because it cannot successfully build the PublicClientApplication when the customers follow our readme and official documentation to use it with their own tenant.

The reason for this is that the sample contains its own keystore and points to this keystore in the build files. The official guidance on getting a debug Signature Hash will produce the default debug Hash for the customer's instance of Android Studio; however, this sample builds with its own Signature Hash. So by following our guidance, the customer is actually using the incorrect Signature Hash to generate a redirect Uri and intent filter.

This can be resolved by explicitly explaining how our customers can customize their keytool command specifically for this sample. (Basically the customer needs to change the path to point to the project's keystore).
Even just pointing out the fact that the sample uses its own keystore and the customer will need to adjust the keytool command will be a great improvement.

Step 5 in the portion in the readme about using your own App Registration might be a good place for this:
image



Thanks! We'll be in touch soon.

Dominant language
Java
Stars
34
Forks
30
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Azure-Samples/ms-identity-android-java

All issues in Azure-Samples/ms-identity-android-java

Similar issues

More Java issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.