From fd7936c944ae345d9a7722b6fa3f6cec948a0049 Mon Sep 17 00:00:00 2001
From: Daniel Vozenilek <vozendan@gmail.com>
Date: Sun, 9 May 2021 20:37:33 +0200
Subject: [PATCH] ibmcloud-login: add page (#5891)

---
 pages/common/ibmcloud-login.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 pages/common/ibmcloud-login.md

diff --git a/pages/common/ibmcloud-login.md b/pages/common/ibmcloud-login.md
new file mode 100644
index 000000000..28d724b66
--- /dev/null
+++ b/pages/common/ibmcloud-login.md
@@ -0,0 +1,28 @@
+# ibmcloud login
+
+> Log in to the IBM Cloud.
+> More information: <https://cloud.ibm.com/docs/cli?topic=cli-ibmcloud_cli#ibmcloud_login>.
+
+- Log in by using an interactive prompt:
+
+`ibmcloud login`
+
+- Log in to a specific API endpoint (default is `cloud.ibm.com`):
+
+`ibmcloud login -a {{api_endpoint}}`
+
+- Log in by providing username, password and the targeted region as parameters:
+
+`ibmcloud login -u {{username}} -p {{password}} -r {{us-south}}`
+
+- Log in with an API key, passing it as an argument:
+
+`ibmcloud login --apikey {{api_key_string}}`
+
+- Log in with an API key, passing it as a file:
+
+`ibmcloud login --apikey @{{path/to/api_key_file}}`
+
+- Log in with a federated ID (single sign-on):
+
+`ibmcloud login --sso`