bugraoz93 commented on code in PR #55633:
URL: https://github.com/apache/airflow/pull/55633#discussion_r2349765884


##########
airflow-ctl/docs/howto/index.rst:
##########
@@ -66,15 +77,36 @@ In both cases token is securely stored in the keyring 
backend. Only configuratio
 is the API URL and the environment name. The token is stored in the keyring 
backend and is not persisted in the
 configuration file. The keyring backend is used to securely store the token 
and is not accessible to the user.
 
-Datetime Usage
-''''''''''''''
-For datetime parameters, date should be timezone aware and in ISO format.
-For example: ``2025-10-10T10:00:00+00:00``
-Let's take example of triggering a DAG run with a logical date, run after and 
a note.
+What is authentication for ``airflowctl``?
+``````````````````````````````````````````
+For ``airflowctl`` to be able to communicate with the Airflow API, it needs to 
authenticate itself and acquire token.
+This is done using either a token or a username and password.
+The token can be acquired from the Airflow API or generated using a username 
and password.
 
-.. code-block:: bash
+.. image:: ../images/diagrams/airflowctl_api_network_diagram.svg

Review Comment:
   I think those are great questions Jarek :) I was thinking the same but 
didn't know we had this. I used draw.io and thought about adding that as well 
for further editing but couldn't find a similar approach. I found SVG files 
with diagrams. I missed this and I was unsure how they are generated and added.
   
   It makes sense and thanks for the direction! I will update and use that 
approach 



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to